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From the Editor ^ 



he last monili of tlie year always inspires the desire to look hack and see where weVe been. 


It's probably useful to do that individually, certainly, but also as a community. 2011 brought both 


m incredible highs and lows. We saw the release of the iPad 2, lOS 5, OS X Lion along with new 
hardware that seems to keep exceeding people's expectations. Of course^ tliis all came along with 
tile loss of Steve Jobs, the cO“founder and [uiiilic personality of Apple. We saw Apple’s stock [leak at 
$422,24» which, at some point in the past* seemed impossibly out of reach. But then, Apple routinely 
makes the seemingly impossible, possible. 

Of course, coming up on a new year inspires us to look forward. Now, I’m not one generally for 
New Year’s resolutions, liui it happens tt) be a great practice for your tech-self Make a big resolution, 
or a small one. Revamp your entire application. Learn a new' language. Better learn your text editor 
Learn a new command for your stmrce control. Learn a new shell command. Any one new tiling, just 
pick one and follow through. 

We’re going to help you on this path, of course. Get an early jump on your resolution, starting 
with this month, 

This montli's Mac in the Shell guides you tlirough one way of getting even more shell commands 
onto your Mac so you have more to choose from to learn. The introduction to Homebrew is just the 
beginning of what you can gel oui of a source-based package manager. 

Regular (and frequent) et>ntribuioi‘ Mihalis Tsoukalos show you how to use Octave, a specialized 
open source math package that can replace MaiLah. if you have the need for .something more 
powerful than be or Excel, check out Octave, 

If you’re IcKiking to learn a new^ language, you should be following Peter Hoseys series on 
Objective-C. Peter has covered the ba.sies of C, and built up to the extensions that make up modern 
Objective-C. This monlli, he expands on the object hierarchy and how^ objecLs know about one 
another. 

To expand your horizons beyond a pure OS X itilrastructure, Greg Neagle's Mac Enterprise 
column covers Repasado, a w^ay to run a Software Update Server withoui OS X..,on any platform that 
siippons P>^hon, 

Naturally, we can all learn from our fleers, so check out w'hat Guy English has t(3 say, us lie's 
featured in this month's .MacTech Spotlight, Guy wears many hats* in the Mac community and [wrings 
great perspective to his work. 

Finally, no matter your tech-resolution, we want to help out. Let us knew wliat you’re kx^king 

for at letter5@mactech.com. See you in 2012! 


Edward Mairzak, 
Executive Editor 
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Mac in the Shell 

by Edward Marczak 


Brewing Up 
Missing Apps 

Using homebrew to install 
additional apps on OS X. 

_ _ _. 

Introduction 

OS X US really an incredible system: a beautiful GUI, 
and a powerful Unix subsystem. Apple incltides a wealth of 
tools right out of the box. From scripting languages like 
Ruby and Perl to familiar Unix utilities like tidy and awk to 
Apple-specific command-line tools like sips and textutih 
Even with all of this power, there are other tools available. 
As the technology craftsperson, you need to choose the best 
tool for the job. That's where third-party package managers 
come in: to easily install all of the .sol tw'a re that you need 
that Apple didn't indude. 


written about in the October 2010 issue of MacTech 
Magazine. Munki is a package manager where you control 
the catalog available for your fleet. Compare that to Fink, 
Macports and Homebrew, wdiere you pretty much rely on 
package maintainers to create Mac-specific ports of code 
that the package manager can install. Perhaps Apple’s real 
package manager is the AppStore? (OK, ifs largely an 
incomplete package manager, but there’s potential there.) 

All three major package managers—Fink, MacPorts and 
Homelirew—stay out of the way of stepping on system 
binaries and make for easy removal. 

Installing Homebrew 

I’ve written about Macports in the past, but wish to 
explore an alternative this month; Homebrews Homebrew^ is 
a relatively new third-party package manager for OS X, and 
ri] be focusing on the experience on Lion. This is a great 
time to jump into Lion, as 10J.2 has cleared up a number 
of issues, along wdth the latest version of Xcode (4.2.1 as of 
this wTiting), which also includes llvm and clang options. 
You’ll need Apj;jle’s Developer Tools installed prior to 
running any [lomebrew commands. So, if you need to, go 
to the AppStore and install the Xcode installer. (That’s right: 
the Mac AppStore doe.sn't install Xcode. hui rather, it installs 
an Xcode installer, which you then need to run to actually 
install Xcode. Ensure this is all complete before 
proceeding.) Next, run the Homebrew' installer: 

/ufir/bln/cuby -e ""Stcurl -faSL 
https: / /raw. git hub . cuiii/giEjt/3 23731 )"" 


Utopia (it isn’t) 

What else could you possibly want, right? 05 X includes 
everything you'd ever need! As it turns out, there are a lot 
of useful utilities. Like all good Unix sy.stems, this software 
is just waiting for you to install. On most new machine.s, 
there are certain things I'd like to have available and set tip, 
and a package manager is just rhe tool that will help gel this 
done. 

As a quick aside, package management is difficult. 
Apple keeps making steps in the direction of putting a real, 
full package manager on OS X, but hasn’t ever really went 
all the w^ay. Hence the need for third-party tools. There have 
been several attempts over time. Fink 
(http://www.finkproject.org/), is really the oldest of these, 
and is up to date for Lion. MacPorls (nee DarwinPorts, 
available from http://www,macports,ofg/) has also been 
around for a bit, The new^est package manager, and subject 
of this article, is Homel>rew 

(http;//mxcl.grthub.com/homebrew/). Also worth mentioning 
is Munki (httpy/code.google.com/p/munki/), which was 


(See the Homebrew liome page linked above for more 
informaiiun about this installer and script.) 

Another aside: Homebrew, as yorrit .see, is a little 
different frujii other package managers. By default, 
Homebrew' sets itself up in a way that requires the id 
in.sialling it be in the admin group. Additionally, it wnll 
cbowm /usr/local to the id cjf lire penson installing It. If these 
are deal-breakers—and they very well may be—other 
options include in.stalling in your home directory by 
expanding an archive, and/or not iastalling/using it at all. 
(Seriously, if you can't reconcile the security implications 
with yourself, don't use it. I ll claim this for any softw^are.) 

When you run this script, and it runs its initial checks, 
it will alert you and request permission for the changes it is 
about to make. Once it completes, run brew update. 
Brew’s update command populates the git repository that 
Homebrew^ uses for all of its brews. (Xcode now includes 
git, w hich is one reason w4iy you need to install Xcode prior 
to running the brew command. Interestingly, installing git is 
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one of the main reasons I used lo get a package manager 
like Homebrew installed^ 

Ready For Use 

Once the Homebrew package manager is installed, 
you’re ready to use it to install the software you really want. 
You’ll need Internet connectivity anytime you need to fetch 
a package, and possibly its dependencies, from scratch. Let’s 
start with something simple: ctags. Specifically, exuberant 
ctags (“A multilanguage implementation of ctags”), Apple 
does include ctags in OS X, but iFs a bit anemic. Leds see if 
Homebrew can help out: does it have a port for this 
package? 

$ brew search ctags 
ctags 

Yes! Let’s get some more info and ensure it’s the right one: 

$ brew info ctags 
ctags 5-8 

http://ctags.sourceforge-net/ 

Not installed 

http: / i github.coniynixcl/homebrew/coramits/raaster/Library/For 
fliula/Ctaga, rb 

Excellent. Now, to install it, it’s a simple matter of asking 
Homebrew to install it: 

brew install ctags 


Homebrew will download, compile and install ctags under 
/usr/local/bin. 

Now, one of the only reasons I ever install Exuberant 
ctags is for integration with Vim, Not just any Vim, though: 
it’s MacVim I’m after. 1 used to just grab the binary 
distribution from GitHub, but the way it’s currently 
configured makes that a bit of a pain to automate. However, 
like Vim, MacVim is open source and available as a package 
in Homebrew: 

S brew search macviin 
macviia 

Now, if you know a bit about MacVim, you can get 
different behavior depending on how you compile it. You 
may want a very small, stripped down version of it, or, you 
may want to include everything it offers. Homebrew can tell 
you the pre-defined options that a package has using the 
options command: 

$ brew options tiacvlm 
macvim 

-cuEtom-icons 

Try to generate custom document icons, 

-with-cseope 

Build with Cscopa support. 

-with-envycoder 

Build with Envy Code R Bold font. 

-override-system-vim 

Override system vim. 

-enable-clipboard 

Enable Systetn clipboard handling in tbe terminal. 
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There’s une more option built into Homebrew that Tm going 
to use here: —HEAD. The —HEAD option builds from the 
latest check-in. So, our command looks like this: 

brew install macvim enable'clipboard ^ith-envycoder — 
HEAD 

At the end of the MacVim install, you'll be told that since 
this run produces a binary that conflicts with a system 
Innary (vim), that it's not put into /usr/local/bin 
immediately. You’re instructed to type 1^rew link macvini’ to 
link the binary into /usr/local/bin, and you should likely do 
so now. 1 also go one step further and link the MacVim 
directory into my home Application directory: 

In -s /uar/local/Cellar/macvim/HEAD 
$(HOME I/Applications/MacVim 

(You may need to create -/Applications first.) This allows 
me to easily acce.ss the MacVim Gill app. 

There are hundreds of packages available, hut there’s 
one in particular that 1 like to have on a system that 1 use: 
Wireshark. If you've been wanting to follow along with 
some of the Wireshark articles that MacTech Magazine has 
been running, here's your change to easily get set up. Let's 
look at doing this now. 


First, a brew search tells us that Wireshark is 
available. A brew options command tells us that there is 
one option: —with-x. Since this is what compiles up the 
GUI, you want this option. Fm going to add in some further 
options. 

First, 1 like more detail in what's actually happening 
when, so 1 include -vd, for “verbose, debug.” Next, 1 want 
to take advantage of the new, powerful capabilities of llvm 
and clang. So I add -use-llvm and -use-clang. The 
final command looks like this: 

brew' install -vd wireshark —with-x —use-llvm —use- 
clang 

You can now w^atch (or, get a beverage) as Homebrew 
downhiads and compiles Wireshark along with its many 
dependencies. Really, it takes a w^hile. However, you end up 
w'ith a working, optimized version of Wireshark on your 
machine. 

How Did I Get Here? 

Homebrew relies heavily on git and having a clean git 
repository of the packages it offers. Each formula that 
Homebrew uses to know' what to dts is a Ruby script. In this 
manner, you can alter what’s happening, fix issues with 
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outdated or otherwise non-working formulae, or, contribute 
your own. 

If you’re interested in creating your own Homebrew 
formula—either for inclusion in the Homebrew^ collection at 
large, or for simple internal distribution—you use the create 
command; 

3 hrev create http;//example. com/foo - 0.1, tar. g 2 S 
Created /ust/local/Library/Formula/foo.rb 

The URL here is the URL to the downloadable source, 

The great thing about a shell tool is that it can l>e 
automated. I switch and move between machines pretty 
often. I have a setup script that configures a given Mac for 
me in just the way I want it. Part of my script simply does 
all the things mentioned in this article; it checks for Xcode 
and if present, runs the Homebrew installer, installs the 
packages mentioned and links them in place, (In reality, 
there are a few other packages 1 install, including gfortran 
and R.) 

Troubleshooting 

A deep guide to troubleshooting Homebrew is a little 
outside the scope of this article. However, just keep this in 
mind: don’t panic. If anything in Homebrew fails, you do 
A^Or damage your system. All of the OS X tools are still 
intact. In a worst case scenario, you could remove 


Homebrew and reinstall, although that’s typically not 
necessary 

Before installing any new package, you should run 
brew update to ensure that you have the latest formulae. 
Even having done that, things on this big, crazy Internet 
change daily, and a site that once offered a download may 
no longer offer it or just temporarily be down. You can 
inspect what a formula is doing by issuing ’brew edit 
[formula]”. To see how simple a given formula can be, try 
brew edit browser. For something more practical, try 
brew edit etl. In the latter example, it’s pretty clear 
where the formula expects to download the source from 
(the 'uri parameter) and how to go about installing it (the 
1n.staLr method). Does the source download for you 
manually? (Use curl or your web browser.) Does a brew 
update resolve the issue? 

Failing to resolve your issue with those tips, there’s one 
that’s almost sure to work: a Google search. Homebrew has 
an active community and you're likely not the first one to 
notice the problem. Very often, this leads you to the 
Homebrew' tracker where someone has already posted a 
solution. 

Conclusion 

.Apple makes pragmatic choices as to \vhat to include in 
the base OS. It strikes a great balance bemeen common 
utilities and bloating the system with the kitchen sink. Now 
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thai you know how to add the tools you need, there's no 
reason you can't be the most effective at your craft. 
Homebrew makes it easy to install those extra tools, or 
custom versions of them, to boost your productivity. If you 
don/t choo.se Homebrew, I encourage you to check out Fink 
and MacPorts as ways to add those missing applications to 
your system. 

Media of the month: “The Pragmatic Programmer: From 
Journeyman to Master,” by Andrew Hunt and David Thomas. 
Even if you're not a “programmer,” give this a read. 
Seriously, The tips, tricks and discipline it lays dowm is 
applicabie to anyone in computer tech. 

Until next month, keep brewing! 
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Object Orientation 

by Peter Hosey 


Properties and 
Other References 

Objects knowing about 
^other objects _^ 

Previously... 

month, I sliowed how you lay out objects in a clirectecl 
graph that conforms to the Model-View-Controller pattern, 
which clarifies lioth the design of your aj’jplication and the 
ownership graph of its <^>bjects, 

That covers the nodes, but wiiat about the edges? How do 
you actually connect these objects together? 

That's w^hat 111 be showing this month, as t go in depth into 
instance variables, properties, and outlets. 

Instance variables 

As you saw in one of the earlier installments in this series, 
a class can have any number of instance variables. You cleclare 
them in the instance-variables section at the fop of thai class’s 
©implementation: 

@impleinentatlon Person 
i 

//Ohjcclivc-C til.staiicc-variable dec! a rat ions u.sc' tlic sarncf syntax 
as C varialilc dedarations. 

NS St ring *nante, ’postalAddress , * emailAddress. 
^telephoneNumber: 

NSImags * photograph ; 


Wiihin any instance method, it’s possible to access an 
instance variable of any instance of the same class; the syntax is 
object‘>variable (wliere -> is C’s pointer-to-member 
operator, otherwise only used witli pointers to structures). Thus, 
to access an instance variable of self, you can say self- 
>vartable. As a convenience, tlie compiler leis you use the 
variable name alone, leaving the "self->” implied. 

Accordingly, tlie (jnly place where you can access instance 
variables by name alone, without specifying the instance, is 
within instance methods in the class’s ©implementation. 
This is because only an instance method has the implicit self 
argument referring to an instance. 


Class methods have self, but referring to tlie class; C 
functions don’t have self at all (at least not as an implicit 
argument). With no dominanr instance, it’s not clear what object 
you want to access an instance variable of. 

You declare instance variables within a class 
implementation, but diey are imtance variables; the variables 
belong to each instance, not to the class. The class has no 
variables of its own. The declarations simply state w hat variables 
each instance will liavc. 

Every instance gets its own set of instance variables that 
follow' the declarations in its class and .superclasses. Each 
instance’s variables are part of it, so setting an iastance variable 
in one instance does not make the value show' up in the variable 
of the same name in any other instance.^. 

Since instance variables are part of the instance, they last as 
long as the instance, and each variable liolds its value until the 
instance is deallocated or the variable gets a new value assigned 
to it. 

When an instance is created, all of its instance variables are 
initialized to nil. (Contrast w'ith local and global variables, 
which aren’t initialized by default.) This makes it easy to “lazily" 
create any other objects that the new object will need: 
Whenever it needs an object tliat you keep in one of its instance 
variables, you can lest wheiher you have created that object yet 
!)y testing wheiher the variable's value is nil; if it is nil, tlien 
you have not cieated the objecM yet, so you create it and store 
its pointer in the variable for next time. 

(Quick reminder liefoie I continue: I've started assuming 
that you’re using AFtC. If you insist on .sticking with manual 
relerenceK’oitilting, .see the Advanced Memoiy Management 
Prr^gramming Gukle in Apple’s documentation.) 

Instance variables that hold pointers to other instances are 
ownerships of those olijects. As long as you hold an object’s 
pointer in your instance variable, you'll be keeping that object 
alive. Accordingly, you can release that ownership by assigning 
a different pointer (or nil) to the varialile. 

Any owaierships tlmt an <>bjeci holds on other objects are 
automarically released when the owning oiiject is deallocated. 

A variable can be declared with an “ownersliip qualifier” on 
its type. For most variables, this means vei^ liiile. For instance 
variables, however, the ownership qualifier is important 
whenever you need l>c‘hav'ior different fnan the default, 

The default liehavior is for eveiy instance variable that 

points to an oliject to implicitly be_strong, which means 

that it is an ownership. 

On Mac OS X 10.7 and later and iOS 5.0 and later, instance 

variables tliat point to objects can be declared with the_weak 

keyiv'ord. That keyword has two effects: first, the variable will 
not establish an ownership of the object; second, if the object is 

deallocated, any _weak variables that point to it will 

automatically be set to nil, saving you from subsequently 
trying to talk to a dead object (which would usually cause a 
crash). 
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The third ownership qualifier for instance variables is 

_unsafe_unretained. This is like _weak, in that it 

does not establish an ownership (hence “unretained”)j but 
w^ithout the automatic-set-to-nil part: if the object dies, this 
propert}^ will continue to point to it, leaving it possible to send 
a message to a dead object (hence “unsafe''). You generally 
should not use this keyw^ord. 

There is a fourib ownership qualifier, 

_aut ore leasing, but that's only for local variables, so 1 

won't talk about it here. Like all of these, it's covered in detail in 
the “Transitioning to ARC Release Notes" in Apple's 
documentation, and in even more detail in the ARC specification 
on the Clang project website. 

Properties 

A property formally expresses a relationship to a value or 
another object. 

You declare a property w'ithin an ©interface or 

©protocol. A property declaration looks like tills: 

©property(keywords) type name; 

Tlic latter half of tliis wall look veiy familiar: ifs the same 
as a varialile declaration. As with a variable, this declares what 
type of value ihe property holds and the name of the property. 

A property doesni, strictly speaking, declare a variable, 
though. What it does declare is one or two melhods, which are 
the accessors of the property, You send the object one of tliose 
mes^sages to access the property. 

Declaring a property obliges you to implement it in your 
class’s ©implementation. You have several options: 

• ©dynamic propertyName is the hand-wave 
implementation, When you use ©dynamic^ you tell the 
conifiiler ihat the implementation will be provided by a 
superclass, at run time, or both, Yoti mainly use this when 
inheriting the implemenfation from a superclass, such as 
W''hen you suliclauSS Core Data's NSManagedOb j ect. Most 
of I he lime, this is not what you want. 

• ©synthesize propertyName; tells the compiler to 
gen era Le an instance variable and an iinpicmentahon of the 
property s accessor mclhodts). When you don't need your 
accessors to do anything unusual, this is the best chtice. 

• Yc^u can implement either or lirjtli accessor metliods 
yourself When you do this without synthesi?:ing, you need 
to declare an instance variable yourself or create another 
place in which to store the value of the property. 

• You can both synthesize the prof^ert)^ amJ implement either 
or both metliods yourself, llie main reason to do this is so 
you can use the synthesized instance variable from your 
custom accessor method(s), but do something unusual in 
addition to die access. Most cominonly, you1l do this in a 
view class, in order to have your setter set the view' as 
needing display. 

Property keywords 

The property keywords affect the responsibilities of the 
accessor implementations. If you synthesize the 
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iniplementations, the keywords tell the compiler what its 
implementation must do. if you write them yourself, the 
keyvv^ords tell you what your implementation mu-st do. 

* atomic/nonatouiic: Whether the accessors get and set 
the property atomically, such tliat the property can never be 
observed in a state where it has been partially changed, 
atomic is tlie default, but if you write the accessors 
yoursef and doni take any special atomicity precautions, 
you should declare the property as nonatomic. 

• read writ e/re ad only: Whetlier the property’s value 
can be changed. A readwrite declaration declares both 
a getter and a setter, whereas a readonly property 
declaration declares only a getter ©synthesize will 
implement only the method or methods declared by tlie 
©property, so if you declare as readonly and then 
synthesize, the compiler will implement only a getter. 

■ getter=foo/setter=£fetFoo;; By default, the 
selectors of the implicitly-declared getter and setter follow 
the naming pattern for accessors compliant with Cocoa’s 
Key-Value Coding, About the only reason to change the 
getter selector is to rename a Boolean property’s getter horn 
""foo” to “IsFoo” which is also KVC-compliant and is 
more readable for some properties (for example, 
"isEnabled” For a property named “enabled’’), I have 
never encountered a reason to change the setter selector. 

i 

strong/copy/weak/unsafe_unretained/assig 
n: The memory management policy More on this in a 
moment. 

Memory management 

A property^ can have any of Five memory-management 
policies. 

strong is a direct ownership. Assigning an object pointer 
to a strong property establishes an ownership by the 
property holder of the other object. This is the property 

equivalent to the variable key^vord_strong. 

copy is also an owning relationship, but with a t^nst: the 
property holder may become an owner not of the object you 
provided, but of a copy of that object. This is most useful with 
mutable objects such as NSMutableSt rings, 
NSMutableArrays, etc. 

The way the setter for a copy property^ works is to send a 
copy message to the object you provided; that ohjeci must 
respond to the message l>y returning either a copy of itself, or 
itself. The ol)ject tliat the copy message returns is the object 
that will become the new value of the property. (If it dcX!Snl 
respond to copy at all, that’s a bug in your program that will 
cause an exception.) 

weak is the property equivalent to the variable keyiAord 

_^weak: It esmblishes a zeroing weak reference. The property 

holder know.s about the value, but does not own it Cat least not 
dirough this property), and if die object that is the value dies, 
the property will lie automatically set to nil (on Mac OS X 
10 J/iOS 5 and later). 
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unsaf e_unretained is the property equivalent to die 

variable ke^^ord _UTisafe_unretaineci: it does not 

establish an ownership (hence ''unretalned*'), but if the 
object dies, the property will continue to point to it, leaving it 
possible to send a message to a dead object (hence 
"unsafe”). You generally should not use diLs keyword. 

assign is a synonym for unsafe_unretained, but 
since it does not explicitly stale hcjw unsafe it is to use for object 
pointers, you should only use it for non-t>bjec! values, such as 
numbers and stmciures. It’s also the default for properties, which 
encourages you to alway.s specify an explicit policy (usually 
strong, sometimes weak) for object pointers. 

Properties vs- instance variables 

Properties are often public (declared in the 
©interface), whereas instance variables are l>est kept 
private (declared in the ©implementation). 

Properties can only be declared in an ©interface, 
whereas instance variables can be in either the ©interface 
or the ©implementation. 

Properties can be added by categories, whereas instance 
variables cannot. 

You can declare an instance variable with die same xypc 
and name as the property, but you don't need to: when you 
synthesize a prt>perty, you also synthesize an instance variable 
that matches the declaration of the property. 

A synthesized instance variable has the same ownership 
policy as die property it came from, w^hich meaas that you can 


leave a property set to the default policy 

(assign/_unsafe__unretained) and synthesize it, and 

the default poliey for instance variables (_strong) will not 

keep die object alive anyway. (That said, for properties and 
instance variables that refer to objects, you should use weak or 
_weak whenever possible.) 

While a propert)-^ can create an in.stance variable (as part of 
a ©synthesize directive), an instance variable never creates 
a property. 

A property implies accessor methods, whereas an instance 
variable does not. 

Some notes about style 

As a general mle, it is better to be explicit dian implicit. 

Accordingly, ifs almost always better to make a property for 
everything, even tilings diat you will hold privately. (You am 
declare the property in a class extension to keep it private.) 

For one thing, as previously shown, a property declaration 
should include die ownersliip policy^ for the profiejiyc Explicitly 
declaring that isn't only a gocxl idea for public properties; it's just 
as good for private properties. 

For another, a properly includes accessors. These provide a 
few advantages over an instance variable alone: 

• When something uses Ccxroa's Key-Value Coding .system to 
interad s\ith your object, K\^C will call your acceasors. 
Widiout accessors, it will (by default) access your instance 
variable directly—not .something you generally want any 
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Figure 1 — Xcode's nib editor (center half), with the File's Owner selected in the objects list (middle left quarter] 
and outlet properties listed In the Connections Inspector (far-right quarter). 


object to be able to do* 

• You can set breakpoints on either or both accessors. 

* You can override either or hotli accessors^ eidier to add 
logging statements or experimenial hug^liuniing ccxle, or lo 
implement custom behavior you II want in the final prtjduct 
(e.g., sending yourself setNeedsDisplayr in a view). 

For these reasons, you generally should make every tiling a 
property, whether you make it public or private. 

Using properties in init 

Tliere is a risk to using your properties in ini t. A property 
access Is a message, so if you have (or a sulx:]a.ss lias! ) a custom 
implementation of the accessor, using that implementation on an 
object you haven’t fully initiali;^ed yet may be unsafe. 

As an example, let’s say you have a class Foo and a 
subclass Bar. Foo declares an image property and 
synthesizes it, and Bar overrides the accessors for the property 
with some custom logic. Bar’s implementation looks like tliis: 

©interface Bar () 

@prope rty{weak) NSGache *ima geCache: 

©end 

©implementation Bar 
©synthesize imageCache; 

- [id) Init [ 


if f (self = fsiiper init]}} ( 

self .imageCache - /^Obtain the catUie from somewhere'*/ 

) 

return self; 

1 

- {NSImage *) image I 

return [self.imageCache objectForKeytself]; 

1 

- (void) setimage; [NSImage *)newliiiage t 

[self t iiiiageCache setObj act: new Image forKey: self]; 


©end 

Foo’s implementation looks like tliis: 

©implementation Foo 

©synthesize image: 

- (id) init I 

if ((self = [super init])) f 

self-image = [NSImage imageNamediNSImageNameUser] : 

I 

1 

©end 

The first thing Bar’s implementation of init does is call 
[super init] (as it should). Foo’s implementation then 
sends to self a setimage: message (written above as a 
property access expression). 
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But remember tliat self is a Bar instance, and Bar 
overrides setimage:. Moreover, Bar's implementation of 
s et lira ge i relies on something that its init will set up, but 
hasn't yet because it's still waiting for [super init] to 
return. 

In this case, what wilt happen is that - [Bar 
setimage:] will send that setQb j ect: f orKey : 
message to self. image Cache, which is .still nil, so 
notliing will happen. The object that should have an image by 
default will not have one because of this bug. (Worse, if only 
some of these objects are Bar instances while others are direct 
Foo instances, then some^—the Foo instances—^will have 
images by default while others won't, and you may not be able 
to tell which are which in your user interface.) 

liie upshot of all of this Ls that it's safer to access instance 
variables directly, and not use properties, within 
implementations of init and other initializers. 

On tile otiier hand, that's also a rare situation. The above 
example is quite contrived. Most of the time, all relevant 
properties are ©synthesized and, even if you have a 
sul)class, it has no reason to ovenidc them. 

On top of that, sometimes you want an accessor 
implementation to run. For example, perhaps tlie property is 
declared as copy, and the object that init. obtains and w^ants 
to store in the property may tx^ mutable. In that case, you would 
want to store a copy, not the original, mutable object, in the 
properly. Wrirtng a copy message in init is a thing repeated; 
you have specified that it must he copied lioth in the property 
declaration and in init. Ihis violates tlie ]>rinciple of DRY 
(Don’t Repeat Yourself). 

So it’s a tnide-ofl. There are reasons behind each practice. 

My recaimmendation, especially under ARC (which 
eliminates 9W3 of memory-management code that would have 
had to be repeated without it), is io assign directly to the 
instance variable in init as yt>ur normal liehavior, and only 
use an accessor—or any other meiliod of self^—from init 
only wiien you really need to, for a synthesized property 
declared as copy, I would use the properly from init. 

Accessing properties vs. instance variables 

Think ht.st: wiiat does this do? 
myImage = fpictureTaker outputImage]; 

Is my Image a property, an instance variable, a local 
variable, or st>mething else? 

Tile answer is that it’s a variable of some kind. You wtmld 
have to find the declaration to he sure, l>ut it could l>e cither a 
local variable or an instance varialile (or a global, tfiough tfiat's 
less likely), 

rnylina ge could be declared as a property, but remember 
that synthe.sizing a propeity also genemtes an instance variable. 
As long as the ©synthesize directive for that properly^ came 
before that statement, the statement would lie valid, and it 
w'ould use the instance variable that you syntJiesized for the 
propeity. 

Whether there is a pro pert}' by tliat name or not, 

' my Image " is noi an access of a properly. A property' access is 
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a message, and tliar isn't any kind of message expression. It 
accesses the my Image variable directly. 

If you wrote a custom setMylmage : implementation, it 
doesn’t get called. Even if you didn’t write a custom 
implemeniation, if you declared the property as copy, die copy 
is done by die synthesized setter mediod, which doesn’t get 
called. 

The correci code would he this: 

self .mylmage “ [pictureTaker outputltnage] : 

Which translates to this: 

[self setMylmage:[pictureTaker outputImage]]: 

Either of these expressions uses the property’s accessor 
method, so the memory-management policy—and any other 
desired side effects—will be upheld. 

When you really do w^nt to access an instance variable, not 
a property^ you can be explicit alx^ut it by using the instance- 

variable access syntax described above: 

self->JiiyImage ^ [[pictureTaker outputlsnage] copyl : 

The Mot syntax”, self, my I mage, accesses die property 
(sends a message), whereas die arrows syntax accesses the 
instance variable direcdy, explicitly. The arrow syntax does not 
require a proper^' and does not use any accessor methods. 

Most of die time, you don’t want to access instance 
variables directly because properties are safer. Whenever you do 
sometliing that’s ICuSS safe, it’s good to be explicit about it. 

Outlets 

When you create your user mtetface in nibs or storyboards 
(I’ll refer to both collecdvely as ’’nibs’’ from here on), you often 
need to be able to refer to diose objects in your code. For 
example, a controller may need to gel a value horn a view in 
order to set it somew^here in the model. 

it’s easy to refer to an object that you create in the code, 
but what about objecLs you create in nibs? 

That’s wliere outlets come in. 

An outlet is a propert}' that you declare with the 
IBOutlet keywwd f'lB” standing tor Interface Builder, 
anotlier name For Xcode’s nib editor view), like so; 

^property[weak] IBOutlet NSTextField ^naineField: 

When you declare that a property is an outlet, it will appear 
in the nib editor when you right-click on die object with the 
property, or when you select the object and look in the 
Connections Inspector. Only properties with the IB Outlet 
keyword will show up; properties that don’t have it aren’t 
outlets. 

Once you’ve created an outlet and revealed it in the nib 
editor, you can drag from its socket (the circle on the right side 
of die outlets list ) to any suitable object. For example, given the 
outlet abt)ve, you could drag from die nameField outlet to 
any NSTextField in the same nib. That connects the outlet 
to the NSTextField object. Loading the nib will sec the 
property to dial r^bject. 
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Outlets VS- properties and instance 
variables 

Any property or instance variable can be an outlet. The way 
to make it one is to include the word IBOutlet before the 
type name in its declaration. 

Prior to the introduction of property declarations, you could 
only use IBOutlet on instance variables, so only instance 
variables were ever outlets. Nowadays, it’s best to make all of 
your outlets properties. 

Memory management 

The memory management policy you should give to an 
outlet property depends on die object's position in the nib. 

A nib contains one or more objects, and some of these 
objects—particularly views, windows, and (on the Mac) 
menus—may contain other objecis. Objects tliat are contained 
by the nib directly, not by anotlier object in the nib, are called 
top-level objects. 

The File’s Owner shouki, as its name says, own all of the 
lop-level objects, so the outlets to those objects should be 
strong. The File's Owner doesn’t need to own any objects 
that are and always will be contained within a top-level object; 
those will remain alive anyway, so it makes clean-up simpler to 
declare those properties as weak. 


There are some extra wrinkles on die Mac. For details, see 
the "Nib Files" chapter of die Resource Programming Guide in 
Apple's documentation. 

Public or private? 

You used to have to declare outlets in the header, but 
with recent versions of the Clang compiler, you can declare 
them in a class extension in the module file instead, That will 

look something like this: 

©interface MyWindowController C) 

©property(veak) IBOutlet MSTextField *ageFleld; 

©end 

There’s a common rule in object-oriented programming 
called the Law of Demeter, which states that every object 
should only talk ro “itself or its friends”, the latter pan 
meaning any objects it creates or has passed to it by 
something else. An object shouldn’t talk to another object’s 
friends. 

From that, it follows that you generally shouldn’t make 
an outlet public. For example, if the ageField property 
shown above were declared in that window' controller’s 
interface, other objects could get or set the field’s value 
directly. 

That may sound fine; why make the path indirect? The 
reason is because then your entire program becomes 
entangled with the Ul. You can’t change the IH without 
having to change things all over your code base. 
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As an example, what if you w'anted to add a slider or a 
stepper alongside the field? Then you would have to change 
every class that sets the value in the field to also set it in the 
slider or stepper—and, when you need to get the value, how 
would you tell which of those controls the user had changed 
last? 

It's better to give the window controller a public 
property for the value, and keep its outlets private. The 
window controller, and the window controller alone, is 
responsible for communicating that value back and forth with 
the Ul. Whatever object created the window controller will 
get the value from it, and pass it along, if necessary, to 
wherever it Ls ultimately needed {ideally in a model objects 

Objects in multiple nibs 

There is no such thing. 

An object cannot be in two nibs a! once. A nib is an 
archive of objects; when you load the nib, you are 
unarchiving (deserializing) those objects. There's no way for 
the nib loader to know that an object in one nib is meant to 
be the same object you got from another nib, so that can’t 
happen: tliey are always two separate objects. 

If you connect the same outlet in two different nibs to 
two different objects, then, regardless of how .similar you 
make those objects or the fact that you connected the same 
outlet to both of them, they remain different objects, and one 
of them will replace the other in your outlet. 

Tliis is a common cause of confusion: you may load one 
nib, perform some setup in code on the object you got from it, 
and then load another nib, and wcjoder what happened to the 
changes you rtiade in code. What hapjx^ned was that you 
loaded another object that had never had those changes made 
to it. and because you had hooked it up to the same outlet, it 
replaced the object that you previously loaded from the first nib. 

So remember that all of the objects within a nib exist 
only within that nib; you cannot share an object between 
multiple nibs. 

Wrapping up 

YouVe learned how to connect objects, both those 
youVe created in code and those you've created in nibs, to 
each other YouVe learned about the difference between 
properties and instance variables, how one uses the other, 
and w^hat it means to make an outlet. 

Next month, we’ll (finally) look at the frameworks! 
Cocoa, Cocoa Touch, the differences between them. Core 
Koundation, Core Graphics, Core Animation, what's left of 
Carbon, and more. 
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An Introduction 

to GNU Octave 


Is Octave a viable MATLAB alternative? 


by Mihalis Tsoukalos 


Introduction 

This article is an introduction to GNU Octave, a highdevel 
interactive language, primarily intended For numerical 
computations that is compatible with MATIAB. 

While GNU Octave is a powertul software package, it is 
free. Octave is often considered a MATLAB alternative, 
MATLAB, a product of MathWbrks, is not free. Altht>ugh 
Octave tries to lie as compatible as possible with MATLAB, 
there are infrequent cases that you cannot directly execute 
Octave code in MATLAB and vice-versa. 

what is Octave? 

The name Octave comes from the chemist Octave 
Levenspiel. GNlt Octave, an official GNU project, is a project 
that started by James Rawlings and John Ekerdt but its main 
developer is John Eaton. 

It can stjlve many different prohlems using its native 
functionalities but it can also be extended using its complete 
programming language. Its programming iangLiage works like 
an interpreter-!he code is executed line by line every time 
you run an Octave program. Octave also has plotting 
capabilities that are covered in this article. 

Because Octave is mainly for performing mathematical 
and numerical computations, it is not a replacement for 
general-purpose programming languages like C, Ohjective-C 
or C++, 

Installing and Using Octave 

When I started writing this article, I had version 3-4.2 of 
Octave, installed using MacPorts, running on my iMac with 
Mac 05 X 10.6.8. I was using the latest MacPorts version (the 
development version) of Octave. J installed it using the 

following command: 

S sudo port install octave“devel 


During the writing of this article, 1 switched to Mac OS X 
10.7.1 using the clean installation option. The aforementioned 
octave-devel version does not currently (at the rime of writing 
this) compile on Lion, so the rest of the article uses the 3-2.4 
Octave version that can be installed using the following 
command: 

^ sudo port install octave 

In order to run Octave, you just have to type ’'octave'' at 
the UNIX .shell. The output will be similar to the following: 

$ octave 

GNU OctavSi version 3.2.4 

Copyright (C) 2009 John W. Eaton and others. 

This is free software? see the source code for copying 
conditions, 

There is ABSOLUTELY NO WARRANTY; not even for 
MERCHANTABILITY or 

FITNESS FOR A PARTICUIAR PURPOSE. For details, type 
'warranty^ . 

Octave was configured for ''i386-apple-darwinll.l.O". 

Additional information about Octave is available at 
http://WWW.octave,o rg. 

Please contribute if you find this software useful. 

For more information, visit httpi//www.octave.org/help- 
wanted.hml 

Report bugs to <bug@octave.org> (but firsts please read 
http://www.octave.org/bugs.htnil to learn how to write a 
helpful report). 

For information about changes from previous versions^ type 
’ news' . 

octave:1> 

The octave command prompt is pretty simple and does 

not offer much help. Type help for more information: 

octave:1> help 

For help with individual commands and functions type 
help NAME 
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{replace NAME with the name of the command or function 
you would 

like to learn more about). 

For a more detailed introduction to GNU Octave^ please 
consult the 

manual. To read the manual from the prompt type 

doc 

GNO Octave is supported and developed by its user 
community. 

For more information visit httpi//www.octave.org. 
octave 1 2> 

You can create a variable called “macteeb" and print its 
value as follows: 

octave;2> mactech=l 
mactech = 1 

octave:3> mactech 
mactech = 1 

octave:4> MacTech 

error: 'MacTech' undefined near line 4 column 1 

The last error message shows that Octave is case 
sensitive, as it cannot recognize a variable named ""MacTech"". 

Octave also supports complex numbers. If you are good 
at Mathematics you should rememlier that complex numbers 
ha%'e a real part and an imaginary part and can be written in 
the a + b i fonnai, where i is the square root of -1, The 
following example shows how you can use Octave to work 
with complex numbers: 
octave:4> cl = t + 2i 
cl = 1 + 2i 

octave:5> c2 = + 2i 

c2 = -1 + 2i 
octave:6> c3 = 4 ^ 5i 
c3 = 4 - 5i 

octave:7> c4 - cl + c2 
c4 ^ 0+41 

octave:S> c5 - c3 * c2 
c5 = 6 + 13i 

octave: 9> real{c5) 
ans 6 

octave:1G> imag{c4) 
ans = 4 


If you want to see the existing variables, you should 

execute the ''ivhof command: 

octave:12> whos 

Variables in the current scope: 


NajRfi 

Size 

Bytes 

Class 

ans 

1x1 

8 

double 

cl 

1x1 

16 

double 

c2 

1x1 

16 

double 

c3 

1x1 

16 

double 

c4 

1x1 

16 

double 

c5 

1x1 

16 

double 

c6 

1x1 

16 

double 

mactech 

1x1 

8 

double 


Total is 8 elements using 112 bytes 

In order to delete a variable, you should use the ^clear 
Kvariable mime>'* command. Be very careful with the “deaf 
command at it works with the wildcard *. For example, m 
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order to delete all the complex variables that start with c, you 

should run the following command: 
octave:13> clear c* 
octave:14> whos 

Variables iti the current scope: 

Attr Name Size Bytes 

Class 


ans IxL 8 

double 

mactech Ixl fl 

double 

I 

Total is 2 elements using 16 bytes 

Tf you want to delete every variable^ just type 
You can also create matrices, vectors and text variables in 
Octave. 

Octave Functions 

Octave allows you to create your own functions, which is 
very practical when you want to execute the same commands 
many times. You can even interact with the user asking her for 
input. In this part, a user-defined function called myJ'imcHon 
Is programmed. 

The function code, saved in a file named myJ’unaionjn, 
is the following: 

I 

f Usage: 

M l ” tiiy_functlon 

I Returns YES is the given number is a prime number 
li NO otherwise 

i 

I Programmerr Mihalis Tsoukalos 

ii Date: Friday 09 September 2011 

I 

function M = rnyfunction 

n = input('^Enter an Integer number: 
if ( ischarfnj ) 

usage("Input must be an Integer number"); 
endif 

NO = 0; 
min - 2 ; 

max = fioDr(n/2); 

for y=min:l:max 

if ( remfn,y) ^ 0 ) 
disp("NO"j; 

NO = In¬ 
break; 
endif 
endfor 

if I NO = Q) 
disp("YES"); 
endif 

endfunction 

What this simple function does is to check whether the 
given number is a prime number. A prime number is an 
Integer number that can only be divided by 1 and itself. The 


algorithm checks the remainder of the input against a range of 
numbers. If the remainder is 0 for one of the numbers, then 
the given Integer is not a prime number. You can use the 
myj'unction as follows; 

octave:6> my_function 

Enter an Integer number: 101 

YES 

octave:7> my_function 

Enter an Integer number: 111 

NO 

octave:B> my_function 

Enter an Integer number: ^^12'" 

usage: Input must be an Integer number 

error: /Users/mtsouk/docs/articLe/Octave »KT/inyfunction.m 

at line 17, column 2 
octave:9> 

You do not have to manually load the file inside Octave, 
All you have to do is to be inside the directory where the file 
is. Also, if you execute ''help myJ'uncHon'' you will get the 

following output: 
octave:1> help my_function 
my function' is a function from the file 
/Users/mtsouk/docs/article/Octave.MT/my_function.m 

Usage: 

[] = my function 

Returns YES is the given number is a prime number 
NO otherwise 

Programmer: Mihails Tsoukalos 
Date: Friday 03 September 2011 

Additional help for built-in functions and operators is 
available in the on-line version of the manual. Use the 
command 

doc <topic>' to search the manual index. 

Help and information about Octave is also available on the 
WWW 

at http://www.octave.org and via the help@*octave.org 
mailing list. 

Does the output remind you of something? Yes, the 
comments at tfie beginning of the myjhnction.m file are 
displayed on screen I 

Octave Packages 

GNU Octave also supports packages programmed by 
others that extend its capabilities. MacPorts offers a big list of 
Octave packages and if you want to use some of them it is 
better to install the MacPorts version if available. 

If you want to see the list of the currently installed 

packages, you should type the following Octave command: 

octave:1> pkg list 

Package Name ( Version J Installation directory 


general * | 1.1.3 | 

/opt/local/share/octave/paekages/general-1.1.3 
plot *1 1.0,7 I 

/opt/ioc a1/s hare/oc tave/pac ka ges/plot-1.0.7 
octave:2> 
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If you want to find more information about an installed 
package, tlie ""pkg describe <package name>'' command shows 
you how: 

octave:2> pkg describe general 

Package name: 

general 

Version: 

1 . 1.3 

Short description: 

General tools for octave. 

Status: 

Loaded 
octave:3> 

You can load and unload packages using the following 
commands: 

octave;5> pkg describe benchmark 

Package name: 

benchmark 
Version: 

1 . 1.1 

Short description: 

The package contains code used to benchmark speed of 
Octave, 

Status: 

Loaded 

octave:6> pkg unload benchmark 
octave:7> pkg describe benchmark 

Package name: 

benchmark 

Version: 


1 , 1.1 

Short description: 

The package contains code used to benchmark speed of 
Octave, 

Status: 

Not loaded 

octave:8> pkg load benchmark 

Writing your own Octave packages is beyond the scope 
of this article. 

A Simple Octave Example 

Octave also supports polynomials of any type. You can 

cre-aie a polynomial as follows: 
octave; 2> € = [15-2] 
c = 

1 5 -2 

This creates a polynomial named c Cc is also an array) that 
equals to 5 If you want to create the polynomial 

d = x'^3 -f- 5, you should type the following command in 
Octave: 

octave :4> d = I 1 0 0 5| 
d = 

10 0 5 

(In Octave, a polynomial is represented by a vector To 
create a polynomial, you enter each coefficient of the 
polynomial into tlie vector in descending order.) 
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In order to evaluate the polynomial for a given value (e.g, 
x=3)* you should use the polyvai (type "help polyvar inside 
Octave for more information) function as follows: 

octave:5> polyvai(d, 3} 
ans = 32 

octave:6> 

Using the mots command, you can find the roots of a 
polynomial. The following example calculates the roots of 
both c and d polynomials: 
octave:7> roots(c) 
ans - 

-5,37228 

0,3722S 

octave:S> roots(d) 
ans ^ 

-1,70953 + G,OOOOQi 
0,85459 + l,4B088i 
0,85499 - 1,480881 

It is visible that the c polynomial has two roots that are 
both real number whereas the d polynomial has three 
rools-two of them being complex numbers. 

Octave can also c'alculate the indefinite integral (using the 
polyintO function) and the derivative (using the polyderiv() 
function) of a polynomial. The following c[]mmands show 
how: 

octave:12> polyint(c} 
ans = 

D.33333 2,50000 -2,00000 0,00000 

octave:13> polyint[dJ 
ans - 

0,25000 0,00000 0.00000 5,00000 0,00000 

octave:14> polyderiv(c) 
ans = 

2 5 

octave:15> polyderiv(d) 
ans = 

3 0 0 

The pc)lyderiv(polyderiv(d)) command -not shown here- 
calculates the derivative of the derivative of the d function. 

Plotting with Octave 

First, lets try a simple plotting command that creates an 
impressive output that can l>e shown in figure T The 
command, that is included in every Octave installation, is the 
following: 

octave:1> surf(peaks) 



Figure 1: The output of the surf(peaks) command 


Note that in order to see the output of die command you 
should have the XI1 environment installed on your Mac OS X 
system. The XU environment ran automatically on my Lion 
system after executing the Octave command. 

It wall now be explained how to plot functions, save and 
customize their output. The first command creates a new 
polynomial, named plotME: 

octave:34> plotKE = [ 1 ^2 3 -1] 
plotME = 

1-2 3-1 

It would seem logical to try to plot it at once, using the 
"^plot" command that you suspect that it exists. If you execute 
""phtfplotMH)'', you will get figure 2. 


I 

IT • 

-I ^ 

-2 L _1 - J - ^ 1_J 

I 15 2 J5 ,1 35 4 

Figure 2: plot(p]otME) 

Figure 2 does look neither good nor professional. The 
problem with it is that it calculated the polynomial’s values for 
h 2, 3 and 4 and then connected the points. Tlus is not what 
we wanted. We want more accuracy, which means that more 
points have to be connected when drawing the graph. AJso, 
we want to be able to define the limiis of the x axis ourselves. 

The Octave way to do that is to define a new variable, a 
vector, that contains the x axis limits as well as the .step value. 
If we want to draw the plotME function in the 1-3, 31 space 
using a .01 step, then we should define a vector variable as 
follows: 

octave:37> limValues =[-3:0.01:3]; 
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Note: If you fot^et to put the semicolon at the end of ilie 
command, you will get lots of useless output. The last step is 
to connect the limViiIues vector with the plotME function as 
follows and then call the ''phr function: 

octave:39> newPlot = polyval(plotME^ limValues}; 
octave:40> plot(limValues, newPlot) 

The first command creates a new variable called newPlot 
that contains the output values. Then, every value pair is 
plotted using the plot command. The output can be seen in 
Figure 3* 


(pdf), jpeg (jpg or jpeg), GIF (gif), TeX picture (tex) and 
UiTeX picture (pslatex). 

Summary 

Octave is a very powerful tool for numerical and 
mathemaiical computations and if you need such a tool, you 
should definitely consider it, I think that you should by now 
wonder why Octave is free; the answer is GNU. 

GNU Octave is a viable MATLAB altemative! 
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Figure 3: The pfot(IrmValues, newPlot) command output 


Altliough the output is much f>etier than before, 1 think 
that we should try to enhance it a little. The followLng 
commands finally create figure 4: 

octave:43> plotflimValues, newPlot, linewidth”, 3)i 
octave:45> set(gca, "ylabeP, text(“string", *'f(x)", Tontslze^ 
25)) 

octave:49> grid on 

octave: 50> legend(‘'f(x)’') 

octave: 51> printUfigure4.png*\ “-dpng"); 



Figure 4: Beautifying the plot command output 


The last command saves the output graphics in png 
format using the yigure4.p?ig'' filename. The other supported 
formats are Encapsulated Postscript teps), Postscript (ps), PDF 
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Introduction 

Sometimes, ditti sets come in die fomi of tree. These sets 
have relations tliat are tcx) complex to be viewed with a talile view^. 
To display diein, we need die aid of an outline view. 

Today’s article Icxiks at how we can use the NSOutlineView 
class to present dita ttees, We will ieam what makes a typical data 
tree and how to parse the items in that tree. We will exiimine htw 
to use dita ,sourcing to shuttle dila to the view. And we will do all 
this using AppleScript and the AppleScriptOhjC (Ai)(3C) code 
bridge. 

Once again, readen^ are ex}xx:led to have a working 
knowledge of Xcode and AppleScript, Tlie demo project iiself is 
available fioin die MacTecli source cfxJe repository^ at 
ftp ;//ftp. rrradech .com. 

The Data Tree 

In a typiciil data tree (Figure I), items are ananged into 
hrctjzchc's and Fach item foniis a n<xle that either links to 

odier items f>r stands alone. 

All branches and leaves share a cammcai iKxle knowji as the 
nxH of the tree (marked here in red). Nodes that link to two or 
more ntxles serve as brandies. ‘Hiose linked la exactly one ncxle 
are the leaves, So, iiy this deftnition, item 'anthropoda' (in olive 
green) is a branch. It anaches to the leaf node 'scorpion' (in 
pink) and la the second branch 'hexapoda' (edive green). Item 
'anthropoda^ is also attached to the nxn, 

Nt)w it is |x.xssible lor a data Ux.'e to have cmly a rcx)l node and 
at least one leaf. Most data trees> however, must have one or more 
branches, or none at all, 


Atihnaliii 



Figure 1, A typical data tree. 


Tlie numlier of branches separating a ncxle from the root gives 
the ieiJei for that node, llius in our example, the leaf item 'squid' 
(marked in orange) has a level of two, 'I he leaf 'scorpion' has a 
level of one, the leaf 'rot if era' (lime green) a level of zero 

ilie greatest level ,sets tlie ckplb (or height) of ilie whole tree. 
Our tree, for instance, lias a deptli of two, Notice tliat tlie levels of 
all the leaves never exceed the depth of tlie tree. 

Relations in the tree 

Items in the data tree relate to each another in a unique way. 
If one item leads to anotlier item, the foniier is considered a pan^nt, 
[he latter its cbikl Items with the s;ime parent and level are 
aiasidered siblings. Those with the same level but different parents 
are comim. 

A leaf item always has a brancli or a roeX as its parent. But it 
cannot have any c hildren. Wlicn a leiii’ item gets a child, it cx^ses 
to Ix^ a leaf and ttiras into a lirancli. A linmch can have tlie root or 
a branch as iLs parent. ,'\nd it cm liave a leaf or anotlier branch as 
it.s diild. Furthennore, a brancli can have two or more cliildien 
present at tlie .same time. 

In aur .sample tree, item 'anthropoda' has 'scorpion' and 
'hexapoda' as its children, Botli 'scorpion' and 'hexapoda' are 
siblings even tliough one is a leaf, the other a btanch, Tlie parent 
for item 'anthropoda' is tlie root 'Anima 1 ia', Items 'hexapoda' 
and 'bivalvia' are cousins since thcfy have the same le\el and 
different paients. 

Uses for a tree 

The dtta tree stnicture plays an essential role in many a 
computing process. Some files, for instance, cxganize data in tlie 
fomi of’ a tree. Consider the web [lage, for iastance, which uses 
1 ffML as its fonnat. 'Hie file stirts witli an <html> tag, maridng the 
rCKJt node. Following the root are tlie <head> and <body> tags. The 
former liolds the page's metuckita, tlie laner tlie main text. Both are 
level-zero tags and Ixith fomi branches adjacent to die root, Widiin 
the <ineta> and <bodY> tags are other tags, marking off specific 
data items, Stimc of these tags form new branches; others fomi 
leaves. 

Filesystems also make heavy use of cbta decs. In tliLs c^se, tlie 
physical driw serves as the root of the three. Off that rcxit are the 
logical ixylumes. dividing the drive space into manageable chunks. 
Fach volume then divides into directories and files, laside each 
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director)' are more directories or files. Both directories imd volumes 
are tlie branches: die files ane die leaves. 

The Outline View 

Due to their unique structure^ data trees ctumol be presented 
as a table. Doing so will not pmserve the relatioas of branches and 
leaves. To properly display a data tree, we need the aid of an 
outline view. 

At first glance, oiidine views liave many of the same traits as 
Uible views. Tliey, loo, divide data into wws and columm. Rach 
column gets its own header, which, when clicked, selects or sorts 
the column’s row items. Selecting a row item extends the selection 
to other items on the s^mie row. 

But where the outline view stands unique is in how^ its le/tmos! 
column beliaves. Leaf items appear as normal rom under diat 
column. Branch items, on die odier hand, appear widi a disdosum 
icon next to itself Clicking this icon starts an ejqxtml etmti, 
revealing the children of that brancht Clicking the icon again starts 
a collap^ eimd thus liiding those children. As a rule, the disclosure 
icon appears only when a branch has at Ikisi one valid diild. 

The view class 

On MatOS X, the outline view is supplied by the Ccxoa class 
NSOutlineView (Figure 2). This €la*is derives from NSTableView, 
thus inheriting many of the latter’s properties and methcxls. To add 
an instance of NSOutlineView to a xib bundle, we u-se the Outline 
View icon from the Library palette of Interface Builder 


HSTablfiView JcF 


1 ine Vietf 




* numborOf ROW! ('i t Integer 

4 expa.i].ditein_(ei;tiniDbject| 

4 reloajijlteig_relo artfThi ldreOi_i(mlUniinject 
, aFlg^booleanj 


The above class diagnim shows four conanon meth<xLs of die 
NSOutlineView class. Tlie mediod numberOfRows() returns die 
toad numlier of row entries displayed by die view, llie total 
includes all child itents visible on the view. But as witli 
NSTableView, tills same total is not the numlxT of entries mible to 
the user. 

The meth(xl expandltemO Uikes a branch item as input. It 
then displays the child items linked to that branch. Each child item 
appears as indented rom beneath the entry for the branch item. 
The method collapseIt:em_() does the opposite, removing the 
indented mws beneath the branch item's entry. Both methods work 
only if die branch item is a valid parent and its row entry has a 
disclosure icon. 

I1ie meditxi reloadItem_reloadChildren_() takes two 
arguments: the tree item and a Boolean flag. If the dag is a true 
2 md the item is a branch, the mediod updates die row' entries for 
that Iiranch and its cliildnen. The update is ^vcimive, affecting any 
child items diat are valid branches diemselves. Now' if die Hag is a 
false, only die tree item is upekted. 

The view layout 

Figure 3 shows the parts tteit rmike up the NSOutlineView, 
On top of the view^ is an iastance of NSTableHeaderView. It holds 
iastances of NSTableHeaderCell, w'hich are used to label and 
contnil each outline column. Fach cxilumn is an instance of 
NSTableColumn, w^hich uses an array of NSCells to display die tree 
data. 

As expected, the leftmost column defaults to showing the 
branches and leaves of the data tree. A triangle marks those 
branches with valid children. The branch is in an expanded state 
when its icon points downw^ards. It is in a collapsed state when die 
icon points to the left. In short, the triangle serves the lole of a 
disclosure icon. 

llie lest of the columns on NSOutlineView are used to show 
data relevant to each tree item. In the exiimple shown, the second 
column describes eacli leaf item found in each bianch. 


Figure 2. The NSOutlineView class. 
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Figure 1. An instance of NSOutlineView. 
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The view behavior 

Apart from its collapse and expand actions, the 
NSOutlineView class exhil:)its many of the same behaviors as its 
KSTableView parent. For instance, clicking a column header,still 
causes a sort event across tliat column. It also selects the cx>lumn 
for other prcxesses. Dragging the header's torders resizes the 
column underneath. Dragging the column header itself repositions 
the column, If the dragged column is the leftmost one, that column 
still preserves the tree items it lias displayed. 

Clicking a Km item also causes a selection event tliat extends 
to all rows, visible or not. A double-click causes an edit event, 
wliich can start an inline edit session or display a separate edit 
window. 

Finally, the NSOutlineView supplies the same hixiks for 
aistom sort and filter niutines. But extra care is required if iliese 
routines are to process the tree items properly. 

Showing The Tree 

To help us learn how NSOutlineView class works with a data 
tree, we will use tlie demo project Gaiyo, which meant “oulltne" in 
Japanese-Romanji. The project show's a single window view^ (Figure 
4) on which sits our outline view. 41ie edges of the outline view are 
Icxked with the Windows's edge^. Resizing the window^ then cau-ses 
tlie outline view' to resize as well. 

( _ Gaiyo DEM O 

) 

i Group D 

j > Text Cell Text Cell 


Figure 4. Main window layout of project Gaiyo. 

Tlie left column of the outline view' gets the header label “Group", 
while tlie riglit gets the label “Description"'. Similarly, the identifier 
for the left column is set to tlie .string 'grup', for the right the siring 
Mesc/. Bodi identifiers are set by chcxising Attributes Inspector 
Irom Interface Builders Tools menu. Tlie cbita source for the entire 
view' is served by tlie script object GaiyoModel. 

The data tree itself is held by the property-list file 
TreeDict.plist (listing 1). 1he tree starts with five animal phyla, 
three o{ which are showm here. Each phylum branches into two 
subphyla, each subphylum into member ojgimisms. And each 
member organism gets a brief description of itself. In short, our data 
tree is a condeased subset of the entire animal kingdom. 

Note that in this sample tree, tlie phylum rotifera does not 
contain any child entries. 

Listing 1. TreeDict^piist^A sample data tree. 


<dict> 

< k&p’ rot i fera< / key> 

<dict/> 

c key> anthropodac/key> 

<dict> 

< ke Y>cnis tai:::ea< / ke y> 

<dict> 

<key>ba rnacIe</key> 

<striiig>exclijsively marine^ and tends to live 
in.,,</string> 

<key>crab<:/kep 

<string>has a reduced abdomen entirely hidden 
by.. .</strin^ 

< keY> shr iinpc / ke y> 

<striiig>found globally in both salt and fresh 
waters</string> 

< key> lobs teK / key> 

<gtring>econoinically important as seafoodK/string> 
</dict> 

< ke Y> he3tapoda< / ke v> 

<dict> 

< key> grasshopper</ke y> 

<string>also known as a short-haired 

gras S hopjpe r< / s t rings 

<key>bsd bug</key> 

<string>parasitic insects that prefer to 
feed.,,</string> 

< key>t ic k< / ke y> 

<string>ectoparasites that subsides on 
blood...</string> 

</dict> 

</dict> 


</dict> 

Again, die complete Gaiyo project is availal:)le from die 
MacTech .source code repositoiy' at tip://ftp.mactech.conn. 

The data source protocol 

The NSOutlineView class pixwides its owm protocol for 
moving data between the outline view' anti its model. In this 
protocol, NSOutlineViewDataSource, are twelve method 
interfaces, four of which are mcimhlon' (Figure 5). All protocol 
methods .supply the Uuget view requesting for data. Some supply 
the row entry' under w hich other tree items may l>e placed. If the 
supplied entry' is a missing value, the desired items are those 
adjacent to the root node. 

i'he fkst method QutlineView_numberOf- 
ChildrenOflterr^O states the niiml>er of children lielong to 
the given entry. It returns the numlier ;is an umigned Note 

the metlitxJ passes the row entry' as a gcmetic ohpcl Use the 
NSObject raetliods isKindOfClass I) and class () to check the 
entry''s a)jTea type. 
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Tlie next niethud outlineView_i3ltem-Expandabl€_( J toggles 
the disclosuixi' ton for each row entry. It returns a Roolean value. 
A value of true nieaas die given enti7 has valid child items, 

Tlie method outlineView_child_ofItein_l) displays die 
child items, if any, for each row entiy^ It adds the extia argument 
aldx, which gives the row index for each child. It dien reams die 
item as a getteric ohjecl. The item appears only on the left-mast 
column, w^hich was reserved for tree items. 

The la,st method outlineView_objeGt- 
ValueForTableColumn_byItem_t) updites die columns on die 
oudine view, including the column meiint to display die trcv items. 
It adds tlie ai};ument aCol, which Ls an instance of NSTableColLiinn. 


Tlie aCol aigument points to die column diat will receive die data 
item, The method also returns its data item as a generic object. 

Figure 6 describes how the protocol works when the oudine 
view appears for die first time. It Is when die view displays those 
tree items adjacent to the rcx>t node. On the left of the sequence 
diagram is tlie oudine vic^v aTgt, on the right the data mcxlel, 
which will be GaiyoModel, For brevity's sake, the method ruimes 
appear without die opening term outlineView . 

First, aTgt inwkes nuiriberOf-ChildrenOfItem_(), passing 
along a missing value as the row entiy^ Then it invokes 
childj)fltem_{) and displays the returned resiiit. Next, aTgt 
invokes isExpandable_() to find out if die displayed entry needs 
a disclosure icon. It repeats these two steps until all the child items 
are displayed. Finally, aTgt invokes 

objectValueForTableColymn_byItem_(). It continues to call this 
mediod for all visible rows and columns. So, if the view has ten 
visible row^s and two visible columns, the method 
objectValueForTabieColumn_byItem_[) w'ill lie called twenty 
times. 

Figure 7 shows die prouxol sec|uence when the oudine view 
refreshes its display. Tills hapix.ms when the view becomes active, 
ready to accept user actions. In tills case, die view' invokes only 
objectValueFor-TdbleColumn byltemO for each visible row 
and column. 

Figure 8 show^s the pixxoco] agiiin, now responding to an 
expand event from the outline vieev. First, the view invokes 
numberOfChildrenOfltem^O, pas.sing along die branch item to 
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Figure 7. Updating the visible entries. 


the methcxi, It tlien aills child_ofltem_() ;ind inserts the child 
item below the hiiinch item. Next, the view calls 
objectVdlueForTableColiunn_byItein_(), Again, it repeals the 
call only Ibr each visible rtm-s and columns. So, if a !)randi enoy 
has two rows of childivn and there are two columns, tlie method 
objectValueForTableQilumn byltem () gets called four times. 
Afterwai'ds, the view' rejieaLs calling isIteiTiExpdnddble_() for 
each visible chiki iicm and displays tlie disckxsure ict)n when 
appropriate, 

The data model 

Listing 2 show's the main code for ihe scripi object 
GaiyoModel. Like most AS<X objects, GaiyoModel uses tJSObject 
as its parent ckiss. Pkis, it declares die propertv' bufferDict as an 
instance of NSMutableDictionary. 

The initialize 0 handler pa^pares the test date tree to l>e 
shown on die ouduie view. It Ix^gins by emailing the lactory metliod 
mainBundle {), wliich returns an instince tjf NSBundle. ilien it 
uses the instance method pathForResource of Type !} to get die 
path to the property-list tile TreeDict.piist, Next, die handler 
uses the factory method dietionaryWithContentsOfFile_() to 
load the data tree. It stoies the data tree, now an instance of 
NSMutableDict ionary into the property buf ferDict, 


Listing 2. Preparing the data model. 

script GaiyoModel 

— iaK)PHK'nilS;B,\SH 

property parent : 'class "NSObject" 

— tniOPBRniiSaNSTANCC 

property buf ferDict : class "NSHu table Diet ionary"' 


on initialize (} 

local tPthi LApp 
local tTmp 

— .sei tlie IcM^'atiun of the ru>it cLitn fik; 

set to jitainBLindle n of class "NSBundle'' -i 
of the current application 
tell tApp 

set tPth to pathForResource_ofType_{'^TreeDict", 

"plist'') 

end tell — tApp 

— kxid the tliita Fde 

— datiiUree:dictionniy 

tell class '"NSMutableDictlonary" of the current 
application 

set tTmp to dietionaryWithContentsOfFils^ttPth) 
end tell — class "NSMntahleDictionajy"' of tlie current application 
set buf ferDict to tT^ 

end initialize 
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Figure S, Displaying the child entries. 


— t'ontinutxl in tilings 3 tf» 1 


end script — GaiyoModcl 

The protocol handlers 

Listing 3 shows how the GaiyoModel object inipiements the 
four cLitit-source protocol hitndlers. Here again tor brevity, we refer 
to eiich handler without tlie opening term outlineView_. 

First up, tlie liandler numberOfChildrenOfltem^O odls the 
tree routine countChildren {) to find out if the given entry aNod 
lias any valid children. Then the handler child_ofItem_() 
invokes tl^c instance method levelForIteir_i), passing along the 
entry aMod, That iasUmce methtxl returns die lev^el of that eniiy^ as 
an integer, Next, the handler uses die tree routine getChildO to 
retrieve the child items for that entiy^ at the ro%v index aldx. The 
routine reaims the items as an NSArray instance, and die handler 
extracts the riglit child with the method objectAtIndex_0. If the 
retrieval fails, the handler assumes a null string as the child item. 
Listing 3* Handling the protocoL 

— Return the tTumix^ of children for the given node 

on outlineView_nu!nbeK)fChilctrenOfItent_iaTgt| aNod) 
local tent 

— letrieve die diild count 

set tCnt to countChildren(aTgt, aWod) 

return (tCnt) 

end ou11 i neView^numberO fChi IdrenO f116Jn_ 

— Return the children for the given index and node 
on outiineViewj:hild_ofrtem_iaTgt, aldx, aNod) 

local tLevi tKe/i tLst 

— identily the data level 

set tLev to levelForrtem_(aNod) of aTgt 

— retrieve the child items 
try 

set tLst to getCbildiaTgtr tLev, atlod) 
set tKey to objectAtIndex_{aIdxJ of tLst 
on error 

set tKey to |string] () of class '"NSString'^ of current 
application 
end try 


return (tKey) 

end outiinGViewj::hild_ofIteiii_ 

— Does the node has any children? 

on outlineView_isItemExpandabIe_(aTgt| aNod) 
local tChk 

— retrieve the child count 

set LChk to countChildren(aTgt, aNod) 
set tChk to (tChk > 0) 

return (tChk) 

end outlineView_isltetnExpandable_ 

— Return the data item for the given outline ceJumn 

on outlineViewobjectValueForTsbleColumnbyltemtaTgt, aCol, 
aNod) 

local tID, tVai 
local tChk 

— check the data level 

set tLev to levelForltem taNod) of aTgt 

if (tLev ^ -1) then 

— set the root item 

set tVal to ’"Animalia"' 

else 

— identify the target outline column 

set tID to lidentifieri {) of aCol as string 
if (tID is "grup'') then 

— redisplay me item 
set tVal to aNod 

else If (tID is "desc") then 

— display die item attribute 

set tetik to isExpandabie_(aNodi of aTgt 
if itChk) then 
set tVal to "" 

else 

set tVal to getDesc{aTgt| tLev^ aNod) 
end if — (tChk) 

else 

set tVal to "n/a" 
end if ^ (HD is "gmp") 
end if — {lljev = -l) 

return (tVal) 

end outlineVievf_obj ectVaiueForTableCo lumnjsyl tsm_ 

The protocol handler isItemExpandable_{} also c^Us 
countChildren 0 to find oul if tlie enwf aNod has at least one 
child, Ii returns its check result as a Bcxilean. Tlie liandJer 
objectValueForTableColumn byltem l) checks the level of tlie 
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entry aNod. If the level is a -1, the liancUer returns the string 
"Animalia"' to mark the root node. Otherwise, the handler uses 
the iasiance method identifier {) to check which outline 
column to update, For the Group column (id 'gruj/), it returns the 
value in afJod. 

For the Description column (id Mesc/), the handler checks if 
aKod is a child item using the iastance method isExpandai>le_(), 
If the check proves true, the handler uses the tree routine 
getDesc () to retrieve the specified attribute. If not, it returns a null 
string. 

The tree routines 

The GaiyoModel objea uses four routines to retrieve specific 
items from its bufferDict property. All lour gets the outline view 
as one of its aiguments. 

Tile routine countChildren () (LLsting 4) Ixigins by diecking 
tlie level of the branch item aUod. If the level is a -1, tlie liandler 
returns the numlier of rotit entries held by buf ferDict. Otherwise, 
the routine uses get Child () to drill down to tlie .specified branch. 
Tlien it returns the number of child items that branch may contain. 
Listing 4, Countif^ the child items. 

— Check if a given node 1ms diildren 
to countChildren (aTgt, aNociJ 

local tCnt, tNod, tLev 

— identify tlie data level 

set tLev to level Fori tem_(aNod) of aTgt 

if ttLev = “1} then 

set tCnt to I countI(} of bufferDict 

else 

— get the number of cliilda'n 
set t^Jod to getChildfaTgtr tLev^ aNod) 
if (tNod is missing vaUue) then 
set tCnt to 0 

else 

set tCnt to I count 10 of tNod 
end if — (tNod is missing value) 
end if — (tLev = -l) 

— return tlie couni nc.sult 
return (tCnt) 

end countChildren 

The routine getChildO (Listing 5) sUuts witli a call to its 
fellow routine path2itein (). ft gets an AppleScript list object in 
return. Then getChild() counts the number of branches it needs 
to tniverse. It us^ a repcL^t lcx>p to w^alk dow'n the data tree, and 
uses tlie insUrtce mediod valueForKey_() to move to the next 
branch, Once reading tlie desired branch, the routine iLses the 
instance metliod allKeys {) to read its cliild items. 

Listing 5- Retrieving the child item. 

— RetLim dif chosen node 

to getChild{aTgt, aLev, aNod) 
local tLst, tCnt, tidx 
local tNod, tEuf 
local tChk 

— retrieve die node pith 

set tLst to path2Item(aTgt, aLeVi aNod) 

— retrieve the node item 
set tCnt to count of tLst 
set tBuf to bufferDict 
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repeat with tidx frocn 1 to tCnt 
set tHod to itm tidx of tLst 
set tBuf to val!ieForKey_(tNod) of tBuf 
end repeat — with tIdx from 1 to Cnt 

set tLst to allKeysO of tBuf 

— remm the retrieval re,sults 
return (tLst} 

end getchiid 

Hie routine getDescO (listing 6) also starts wtli a call to 
path2item(). It too uses the iastance method valueForKey_() to 
drill down the data tree held by bufferDict. But this time, the 
routine converts the value held by the leaf item tBuf into a string. 
And if tBuf holds an empty list, the routine returns the string "— 
” as its result. 

Listing 6. Retrieving the description. 

— Return a description for die given item 

to geti>esc(aTgt| aLev, altffl) 
local tDes, tPth 

— Tidrieve d^c item path 

set tPth to path21tem(aTgt, aLev^ altm) 

— iftricve die item d)escrip(kjn 
set tCnt to count of tPth 
set tBuf to bufferDict 

repeat with tidx Cram 1 to tCnt 
set tNod to item tidx of tPth 
set tBuf to valueForKey_|tNod) of tBuf 
end repeat — with tidx fronn 1 to tCnl 

if ttBuf = U } then 
set tDes to 

else 

set tDes to tBuf as string 
end if — (iBuf is missing value) 

— return the description result 
return (tDes) 

end getDesc 

Finiilly, the routine path2Itef[t() (Listing 7) traces the path 
from the root node to die given tiee item. FirsL ii starts with the tree 
item set inside an AppleSciipl list. Tlien using die instance nietliod 
parentForItem_[) from NSOutlineView, die routine works its 
way Irack to the itx 3 t node. As it does, the routine adds each parent 
branch to the list. Tliea upon reaching tlie r(X)t node, the rt)uiine 
returns die complete list to tlie calling routine. 

Listing 7* the branches. 

— llrium tiic pjith U> a given item 
to p^th2ltem(aTgt, aLev^ altm) 
local tPthr tPfv, tStr, tCnt 

— initialize tlic item piiib 
aet tPth to (\ 

set tPth to (altm as list) & tPth 
set tPrv to altm 

repeat until (tPrv is missing value) 

aet tPrv to parentForltemJtPrv) of aTgt 
aet tPth to (tPrv as list) * tPth 
end repeat — until {tPrv is missing value) 

— finalize die patii 

set tCnt to count of tPth 
if (tCnt is 1) then 
set tPth to n 
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else 


set tPtii to items 2 thrti tCnt of tPth 
end if — (tCntisl) 

— renirn tht* relritf^^ed path 
return {tPth) 
end path2rtem 

The sample run 

Figure 9 showN how Gaiyo displays die four limnches 
adjacent to the root node. Sincre branch rotifera has no valid 
children, it is the only entry without a disclosure icon. But note tliat 
the three disclosure icons are set to their collapsed state. 


Group 

rotifera 
mammalia 
- anthropoda 
I ► mollusca 

Figure 9* The root branches, 


Next^ Figure 10 shows branch mollusca expanded to show its two 
children bivalvia and cephalopoda. As those two cliildren have 
cMdren of their ow'n, tliey appear with die required disclosure 
icon. 


Group 

rotifera 
f mammalia 
^ anthropoda 
V motlusca 
^ bivalvia 
> cephalopoda 

Figure 10. Child items for branch mollusca. 


Figute 11 shows the branch bivalvia expanded to show its four 
children—all leaf items. Note how only the leaf items get entries under 
the Description column. Branch items, on the other hand, get none. 
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Figure 11, Child items for branch bivalvia. 
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Wrapping Up 

The NSOutlineView chss lets us present dam that have a 
tree-like structure. It can differentiate between dam items that 
form branches and those that form leaves. !l can aJso show 
which items are grouped under wliich branch. 

This article has shown us how to use NSOutlineView with 
ASOC. We learned about its data source protticol and how to 
implement said protocol as AppleScript handlers. We learned 
how to load tlie data tree from a property-list file. And we 
learned how to walk the tree and retrieve specific items from its 
store for display. 

So ends our study of the HSOutlineView. But remember, 
there is a different way to present data trees, which is with a 
browser vime. Use the control that best suits your needs. 

Till next month. I bid you well, 
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Introduction 

Many, if not most Mac OS X admiuLstrators are looking to 
reduce their dependency on Mac OS X Serv^er software and 
hardware. Many services provided via OS X Server are easily 
replicated on odier hardware and/or software: DHCP^ DNS, 
LDAP, wel> ser\^ing, file ser\ang, and email, as examples, are 
very straightforward to implement on alternate server 
platforms like Linux or Windows. 

However, there are a few^ Apple-specific .services tiiat have 
been a bit trickier to implement outside of OS X Server. This 
month, we look at a replacement for Apple's Software Update 
service. 

Reposado is a set of tools written in Python iliat replicate 
the key functionality of Mac OS X Server's Software Update 
service. Created and released by Walt Disney Aniimtion 
Studios, Reposado is open source, licensed under the new BSD 
license, Reposado allow's you to run a local Apple Software 
Update seiwer on the hardw^are and OS of your choice. 

Reposado Capabilities 

Reposado, like the Apple Software Update service il 
replaces, can cache Apple updates on a ItJcal web server, 
saving on Internet !>andwidt]i usage For your organization. 

Also, like Apple's service, Reposado al low's an 
administratc^r to approve update.s before they are offered to 
managed clients. 

Additionally, Reposado enables an administrator to create 
any arbitrary^ number of "‘branches'’ of the Apple catalogs. 
These branches can contain any subset of the available 
updates. For example, one could create “testing" and “release” 
branches, and then set some clients to use the “testing” branch 
catalog to test newly released updates. Other clients (the 
majority of clients, in fact) w^ould use the “release” branch 
catalog, which w^ould contain updates diat had been tlirough 
the testing process. 

If you configure Reposado to also download the actual 
updates as well as the catalogs, you can continue to offer 


updates that have been superseded by more recent updates. 
For example, if you are currently offering the Mac OS X 10.7.2 
update to your clients, and Apple releases a 1073 update, you 
can continue to offer the (now deprecated) 107.2 update until 
you are ready to release the newer update to your clients. You 
can even offer the 107.2 update to your “release"' clients while 
offering the 10.7.3 update to your “testing" clients. Offering 
“deprecated” Apple Softw'are Updates is a feature that is 
difficult with Apple's tools. 

Getting Started with Reposado 

What you need 

The Reposado tools. 

Python 23^27 with plLstlib. (Reposado has been te,sted 
with Python 2.6, but should work with 2.5-2.7 as long as 
plistlib is available. plisUib was included as a Mac-specific 
library w^iih Python 2.5, and for all platforms with Pytlion 2.6.) 

The curl binary' (diis is a .standard tool on Mac OS X, and 
available for mtwi other OSes). 

A w^eb server, ApacheZ works w^ell, but almost any 
modern w^eh serv^er should suffice. 

Storage space for the catalogs and update packages. If you 
are replicating all update packages for Tiger through Lion, 
you’ll need approximately 90GB of space as of November 
2011. The need for s]:>ace will grow as Apple releases 
additional updates. If you are only replicating catalogs, youH 
proi>ably need less than 100MB of space, though the exact 
amount of space needed depends on die number of branch 
catalogs you create. 

Getting the Reposado tools 

If you are familiar widi git, the easiest way to get a copy 
of the Resposado tools is to do a git clone from Reposado's 
GitHub site: 
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git clone https://githiib.eom/wdas/reposado.git 

Alternately, you may download the source from GitHub at 
this URL: https://githubxom/wdas/reposodo/zipboll/mosfer. The 
tools are in the code directory. The tools (which are just 
Python .scripts) do not need to he any place in particular to 
operate; you may put them wherever you like. 

Setting up Reposado 

T Create a directory in which to store replicated catalogs 
and updates, and another to store Reposado metadata, Tliese 
may share a parent directory, like so: 

/Volumes/da ta / reposado/httnl 

/Volumes/data/teposado/metadata 

Make sure you have enough space for the replicated 
catalogs and updates. Make sure these directories are writable 
by the user repo_sync will am as^ and readable by die user 
your Webserver runs as, 

2. Configure your web server to serve the contenLs of the 
updates root directory you created 

(/Volumes/ciata/reposado/html in die example above}. 
If you are planning to replicate and serve the actual update 
packages as well as the catalogs, make note of die URL needed 
to access the updates root directory via HTTP. This wall be the 
“Rase URL for your local Software Update Service" when 
configuring Reposado in the next step. 


3. cd to the directory containing the Reposado tools. 
Configure Reposado by running: 

,/repotitil configure 

You'll be asked three questions: 

Path to store replicated catalogs and updates: 

I’his corresponds to the path 

/Volumes/data/reposado/html in step 1 above. 

Path to store Reposado metadata: 

This corresponds to the path 

/Volumes/data/reposado/metadata in step 1 above. 

Base URL for your local Software Update Service 
(Example: http://su.your,org - leave empty if you are not 
replicating updates): 

This is the URL you configured in step 2 above. 

4. Run ./repo_sync to replicate Apple catalogs and 
update packages to your Reposado server. The first time you 
do this it may take several hours to complete if you are 
replicn-ting packages as well as catalogs. (Or even more time if' 
you have a slow connection to the Internet.) 

5. Te.st your work so far by visiting a catalog URL in your 
browser. If http;//su,myorgpcom is the URL for the 
updates root directory you created earlier, then 
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http;//su,myorg.com/content/catalogs/others/i 
ndex-leopard-snowleopard-merged-l.sncatalog is 
the Catalog URL for the Snow Leopard updates catalog. You 
should see a plist version of the updates catalog displayed in 
your browser. 

6. Next test: run softwareupdate on a client, again 
pointing it to your Catalog URL: 

softwareupdate -1 ^atalogURL \ 

"http: //au,niyarg*com/coiitent/catalogs/others/iiidex-leopard- 
aaowleopard.merged'l,sucatalog" 

If there are no errors, youVe successfully configured 
Reposado and successfully replicated Apple Software Updates. 

Configuring clients to use your 
Reposado server 

If you’ve never used the Software Update Service on Mac 
OS X Server, you may be unfamiliar with configuring Mac OS 
X clients to use a Software Update Server other than Apple’s 
server. 

To configure a client machine to use your Reposado 
server, you must set the value of CatalogURL in 
/Library/Preferences/com.appLe _ SoftwareUpdate 
.plist. This Is commonly done using the command-line 
defaults tool: 

sudo defaults write \ 

/Library/Preferences/com.apple.SoftvareUpdatG CatalogtJKL \ 
<catalt>g_url> 

where <catalog_url> is tlie URL to die catalog file. The 
following lists example Catalog URLs for each majtir release of 
Mac OS X supported by Reposador 

Tiger Clients 

http://su.yoijrorg,conn/content/catalogs/[ndex.sucoialog 


Leopard Clients 

http;//su,you rorg. com/content/ catalogs/others/index- 
leopard.merged-1 .sucotoiog 

Snow Leopard Clients 

http://su.yourofg .com/content/cotologs/others/index-leopord- 
snowteopord. merged-1 .sucatalog 

Lion Clients 

http:// su .youforg.coTn/content/ catalogs/ others/ index^ ion- 
sn owleopa rcLleopa rd. merged-1. s ucatafog 

Besides using the defaults tool via a script, a payload- 
free package, or the “Send UNIX Command” facility in Apple 
Remote Desktop, you could also set the CatalogURL using 
Managed Preferences or MCX, 

Implementing Branch Catalogs 

In the examples above, the Catalog URLs point to the 
“raw" catalog as downloaded from Apple. This “raw^ catalog 
features all current updates from Apple. If you point your client 
machines at the,se raw catalogs, your clients may not need to 
go over the Internet to get updates, but your clients will still 
get A[^ple’s updates as soon as they are released by Apple, and 
without an opportunity^ for you to vet them. Apple’s Software 
Update Service has the ability to allow administrators to 
approve only a subset of updates to be offered to clients. 
Reposado has that feature as well. Further, Reposado supports 
multiple "branch’' catalogs that offer different sets of available 
updates. You can use this feature to implement a "unstable, 
testing, release” workflow where a very small number of clients 
(“unstable”) get Apple updates as soon as they are released by 
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Apple- a larger group (hut still a subset) of clients get the new 
updates next for testing, and finally, the updates are released 
to all clients. 

To implement this workflow, you use the repoutil tool 
to create multiple branch catalogs. You tlien selectively add 
updates to one or more branch catalog. For example, let's say 
you create "testing'' and “release" branches. When Apple 
releasesS a new update, it is avaUable in the “raw” catalogs 
described earlier. You could configure a few of your client 
machines to use the “raw’' catalogs. If nothing breaks after a 
day or so, you could then add the new^ updates to the 'besting" 
branch catalog. You would then have a larger group of 
machines that were configured to get their Apple updates from 
the testing branch. Again, after a lew days or a week, you 
could add the new Apple updates to the ‘"release” branch. The 
majority of your client machines wcmld be configured to use 
this “release” branch. This workflow enables you to gradually 
rollout new Apple updates so you have time to test and verify 
diat the updates do not cause issues in your environment. 

Creating and Managing Branches 

To create branch catalogs you use repoutil -new- 
branch: 

./repoutil -new-"hranch testing 
*/repoutil -nevbranch release 

These newly created branch catalogs are empty - you 
need to add updates (or in Apple parlance, “prcxlucts”) to the 
branch catalogs. Products are added using their prcxluct IDs, 
You can get a list of available product IDs using repoutil — 
products, which will print a list like diis: 


041-279D MicBook Pro Video Update 1*0 

041-2859 iPhoto Update 9*2 

041-2472 iWac EFI Firmware Update 1*7 

041*2592 HacBook Air EFI Firmware Update 2*2 
041'2517 Mac mini EFI Firmvare Update 1*4 
041-2515 MacBba-k Pro EFI Firmware Update 2.3 
041-2800 Thunderbolt Software Update 1*0 
[Deprecated) 

041-2167 HP Printer Software Update 2*8 

041-2305 EPSON Printer Software Update 2.9 
041-2S56 Aperture Update 3*2 

041-3123 Thunderbolt Software Update 1.1 
041-3149 Thunderbolt FiriDware Update 1*0 
041*1940 Java for Mac 03 X 10.7 Update 1 1.0 
041-1943 Java for Mac OS X 10.6 Update 6 6,0 


2011-10-24 
.1 2011-10-26 
20U*10'26 
2011-10-26 
2011-10-26 
2011-10-26 
2011-10-27 

2011-10-27 
2011-10-27 
.1 2.011-10-27 
2011-10-28 
2011'1I‘07 
2011*11-08 
2011-11-08 


You could then add the two new Java updates to the 
testing catalog like so: 

./repoutil -add-product 041-1940 041‘1943 testing 
Adding 041-1940 (Java for Mac OS X 10.7 Update 1-1.0) to 
branch testing.,, 

Adding 041-1943 (Java for Mac OS X 10*6 Update 6'6.0) to 
branch testing.*. 


After you are happy with the testing period* you'd add 
them to the release catalog as well: 
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*/repoutil -add-product 041-1940 041-1943 release 
Adding 041-1940 (Java for Kac OS I 10,7 Update 1-1,0) to 
branch release... 

Adding 041-1943 (Java for Mac OS K 10.6 Update 6-6.0) to 
branch release... 


Deprecated Updates 

In the list of products above, you might notice one - 
Thunderbolt Software Update 1.0 - has been marked as 
“Deprecatedh This means it is no longer offered in any Apple 
catalog. As long as Reposado has replicated the item to its local 
storage, you can continue to offer it in your catalogs. It’s often 
useful to continue offering a deprecated product (like tlie OS 
X 10.7,1 update) in the release" branch at the .same time you 
are testing its replacement (for example, the OS X IOJ.2 
update) in the “testing” branch. But eventually you will 
probably want to remt>ve the deprecated update from a 
branch; 

*/repoutil -remove-product 041-2300 testing 

Removing 041-2800 (Thunderbolt Software Update-1.0) from 

branch testing,,. 

Often deprecated products have been replaced by 
updated versions. That's the case here, so we might want to 
add the replacement product to our testing branch: 

,/repoutil ^dd-product 041 -3123 testing 

Adding 041-3123 (Thunderbolt Software Update-1,1) to branch 
testing.., 


Adding and removing items from branch catalc^gs can 
become tedious. If you are using a testing/release workflow 
and would like to promote everything in testing to release, 
there's a handy shortcut: •/repoutil -copy-branch, 
w^hich copies all the contents of one branch to another: 

./repoutil —copy-branch testing release 

This is a fast way to move everything from testing to 
release. 

Configuring Clients to use Branch 
Catalogs 

Once youVe created branch catalogs, youT want to 
configure your clienLs to use one or anotlier branch. The 
Catrdog LTRLs follow a simple rule: for each “raw" Catalog URL, 
branch catalogs append an underscore and the branch name at 
the end of the catalog name, but hefove the “.sucatalog” 
extension, Tf the “raw" Tiger catalog is- 

http: / / su. yQurorg. totn/tont&nt / catalogs / index. sucatalog 
then the testing branch for Tiger clients is: 

http://su.yourQrg,cQm/content/cataiogs/index_testiTig.sucatal 

Dg 

and the release bnmch is: 

h 11 p ; / / s u, you ro r g, c oin / c ontent/ catalog a / iiidex_r el ea b e. sue atal o g 


Introducing a better 
hosting solution. 

Running CloudLinux 
y Limited Accounts Per Server 
^ Fuii cPanel With Each Account 
y Daiiy Backups 
y Free Domain and WIidcard SSL 
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Easy to setup 

_ Easy to a^imintster 

&uilt in Photo<5allery 


As seen on the MacTech Forums 
at applecentral.com 


Visit www.mindraven.com and let us 
show you how we can give your website a 
better home with our shared hosting plans, 
semi-dedicated and dedicated servers. 















Additional repoutil commands 




repoutil has a few more tricks: 
repoutil —branches lists all currently available 
branch catalogs- 

repoutil -delete-branch <branch_name> 
removes a bi'anch. 

repoutil —list-branch <branch_name> lists all 
tlie products in a branch. 

repoutil -deprecated lists all deprecated updates, 
repoutil —product-inf o <product_id> prints 
available detail for <product_id>, 


Caveats and Conclusions 

Reposado does not offer some features of Apple’s Software 
Update service. 

Apple's Software Update service includes an embedded 
web server; Reposado requires you configure a separate web 
server But if you are running Reposado on a machine that 
already has a web server process running (like Apache2) you 
can simply use that. 

Unlike the Software Update module in Apple’s Server 
Admin applicatioUj Repo.sadQ lia*s no GUI. All Reposado setup 
and management is done via the command line. The lack of a 
GUI, however, actually makes it easier to get Reposado up and 
running on a wide range of OSe.5 and hardware. 

Finally, Apple's software update offering automatically 
checks every day for new updates. Since Reposado is not tied 
to a particular OS, it’s up to you to set things up so that 
repo sync runs periodically - each OS handles this sort of 
thing dilferently. 

These caveats aside, Reposado should be of interest to any 
Mac OS X administrator who wants to lessen his or her 
organization's dependency on OS X Sender, w^ho w^ould like to 
implement a testing/release w^orkflow- for Apple updates, or 
who needs to continue to offer "deprecated” updates 
indefinitely. Visit Reposado's GitHub site at 
https://github.com/wdas/reposado, and learn more about Walt 
Disney Animation Studio's open source efforts at 
http://wwwdisneyanimation.com/technology/opensource. 


\\\\ 
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Acquia, Inc. 

150 Presidential Way, Suite 310 
Woburn, MA 01801 
Sales: 888-9-ACQLllA 
Main web site: www.acquia.com 

Acquia gives you answers, tools, and 
support to make Dm pal even better. 

See advertisement on page 35 of this issue. 

Alice Dev Team 

Main web site: www.alictdev.com 

We are a small, professional learn of 
Apple Developers frtim the heart of snow- 
covered Siberia. We design and develop 
utilites, useful tools, entertainment and 
social apps for Mac, iPhone and iPad. Our 
aim is to create the apps that give you joy 
and pul a smile on your face! 

See advertisement on pfige 14 of this issue. 

Audioengine 

555 Naihan Rtl 
Kowloon, 

Hong Kong 

Main w'eb site: www.oudioengineusa.com 

Audioengine designs and biuid.s 
innovative audio products wiiU all your 
music in mind. Great sound, .simple but 
elegant designs, high-quality" materials, 
and truly useful features are wdiat the 
Audioengine Advantage is all ab()Ut. For 
information about our products go to; 
WWW, a ud i oen g i n eusa. co m Awa rd-winn ing 
Sound and the Perfect Audio Upgrade. 

See admrtisement on page 28 of this issue. 

Bockground Backup, Inc. 

209-99 Fifth Avenue 
Ottawa, ON KIS 5P5 
Sales: (866) 838-IRON (4766) 

Main web site: wwwJrongate.co 

Server management and consulting 

See aduerlisement on page 18 of this issue. 


Benchmark Email 

1777 Bellflower Blvd,, Suite 100 
Long Beach, CA 90815 
Sales: 800.430.4095 

Main web site: www.benchmarkemail.com 


Build relatioaships. Make sales. Promcjte 
your goods. Gather ckita. Benchmark’s 
email marketing software delivers 
pt>werful, user-rriendly and affordable tools 
to create, send and tnick liigh-perforinance 
email and newsletter campaigns. 


See advertisimeni on page 45 of this issue. 


BITS Limited 

514 Cathedral Drive 

Aptos, CA 95003 

Main web site: www.bilsltd.ntl 


As many individiuils and eojiTpiinies are 
try ing to reduce their earlKjn tcK>tprinis we, as 
always, are trying to assist tliein because we 
know how Lmp(.)rtfmt energy eonserwition is 
to the planet and every individual, 


See adietlmmenl on page 10 of ihP issue, 


Black Magic Design 

71 Thistlelhwaite Sti^eel 
South Melbourne VIC 3205, 

Au.stralia 

Sales: 408 954 0500 

Main web site: www.blackmagiC'design.com 

Blaekmagic Design creates the world’s 
highe.st quality^ videt) editing products, 
color correctors, video converters, video 
monitoring, routers, live production 
switchers, disk recorders, waveform 
monitors and film restoration software for 
the feature film, post-production and 
television broadcast industries. 


See advertisement on page 17 of this issue. 


Brad Sniderman 

23679 Calabasas Road ^55B 

Calabasas, CA 91302 

Sales: 818-706-0631 

Main W'eb site: www.sniderman.Gom 

I was admitted to the State Bar of 
California in 1995 and am now w^orking as 
a sole practitioner, focusing in Wills and 
Trusts, Intellectual Property, Business, 
Commercial and Corporate Law'. 

See adveriiseTneni on page 14 of this issue. 

CobleJive 

380 Pleasant St, Ste 25 
Malden, MA 02148 
Sales: (781) 350-3055 
Main web site: cable jive, com 

See admrtisemenf on page 24 of ibis issue. 

codeforlytwo software 

1 Main St, 8E +400 
Minneapolis, MN 55414-1035 
Main w'eb site: www.code42.com 

Our latest inventioii is CrashPlan ^ the 
mc}st simple, most reliable and smartest 
backup on earth. A pretty hefty claim, but 
true! CrashPlan eompre.sses, encrypts and 
atitomaiically transmits your files offsite. 
What do you say? Others do tliai loo? Not 
like this they don’t! This bad boy has been 
ctK^king in our labs for years! 

See advertisement on page 19 of this issue. 

ComputerTree 

1760 Jonestown Rd, 

Winston-Salem, NC 27103 

.Sales: (800) 467-9820 

Main web site: www.computertree.com 

Since 1982, ComputerTree has l>een a 
tRisted partner, consultant and re.source to 
the publisliing, retail, entertainment, new' 
media and education industries. We offer 
turnkey solutions and experience in cross- 
platform integration, corporate 
communications, marketing, content 
management, device management systems 
and deployment services 

advertisement on page 18 of this issue. 
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Dartware LLC 

66 Banning Street, Suite 7 
West Lebanon, Nli 03784 
Sales: 877.276.6903 
Main web site: www.dQrtware.com 


InterMapper(r) is a leading network 
monitoring, mapping and alerting 
application. It’s an easy to configure 
and fully featured management tool 
with an integrated robust NetFlow 
analyzer. These innovative tools earn 
quick ROI by proactively notifying 
administrators lo potential hardware, 
software and bandwidth issues that 
could cau.se business interruptions. 

See adi^ertisemen! 07i page 13 of this issue, 


Data Jack 

14911 Quorum Dr., Ste 140 

Dallas, TX 75254 

Sales: 1-888493-4522 

Main web site: wvw, data jack.com 

Datajack offers a range of flexible and 
affordable data plans with no contract or 
activation fees. 

See advertiseme7it on page 41 of this issue, 

DriveSavers Data Recovery 

400 Bel Mario Keys Blvd 

Novato, CA 94949 

Sales: 800-440-1904 

Main web site: www.drivesQvers.com 


The ultimate data recovery service. 

See advertisement on page 34 of this issue. 


e3 Software 

465 Fairchild Drive, Suite 229 
Mountain View, CA 94043 
Main web site: ethreesaftware.com 

Powerful email marketing software for 
your Mac. 

advertisement on page 21 of this issue. 
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Facet Corp. 

5999 Summerside Dr. 

Ste 210 

DaUas, TX 75252 

Sales: 972.985.9901 

Main web site: www.facetcorpxom 

FacetPhone reduces costs, increases 
productivity, and seamlessly connects 
remote offices and telewcjrkers. Learn 
how your business or contact center can 
benefit from a feature rich, highly scalable 
FacetPhone system. Now with the 
FacetPhone server software running on 
Mac OS X, this is THE phone system for 
Apple enthusiasts! 

See advermement on page 5S of tha^ issue. 


Foronics 

620-609 Granville St. 

Vancouver, BC V7Y 1G5 

Main web site: wwwimclraining.com 

Deep Freeze instantly protects and 
preserves baseline computer 
configurations. No matter what changes 
a user makes to a workstation, simply 
restart to eradicate all changes and reset 
the computer to its original state - right 
down to the last byte. Expensive 
computer assets are kept running at 
100% capacity and technical support 
time is reduced or eliminated 
completely. 

See advetiisement on page 33 of this issue. 


Fiberlink 

1787 Sentry Parkw^ay West 

Building 18, Ste 200 

Blue Bell, PA 19422 

Sales: 1.855 .maas360 

Main web .site; www.moas360.com 

With 20 years of experience in 
delivering enterprise mobility 
management solutions, Fiberlink has the 
in-depth functional and technical 
expertise necessary to accelerate 
deployment, reduce risk, increase 
employee productivity, and simplify 
mobile device management. 

See advertisement on page 7 of this issue. 


FileWave (USA), inc 

10714 Square Praurue Dr, 

Fishers, IN 
46038-7815 

Main web site: www.filewavexom 
See adi^ertisemenl on page 54 of this issue. 


Future Media Concepts 

299 Broadway, 

Suite 1510 

New York, NY 10007 

Sales: 877-362-8724 

Main web site: www.fmciraining.com 

Future Media Concepts, Inc., the 
nation’s premier digital media training 
center, provides manufacturer- 
authorized training in all areas of digital 
media including digital video and film 
editing, web design and development, 
sound design, DVD authoring, 3D 
animation, motion graphics, desktop 
publishing and Mac IT. Certification 
testing and on-site training are 
available. 

See adi^rtisetnent on page 59 of this issue. 


Gefen Inc. 


20600 Nordhoff Street 
Chats worth, CA 91311 
Sale.s: (800) 545-6900 
Main web site: v^ww.gefen.com 

Gefen supplies a wide selection of 
signal switchers, splitters, extenders, 
scalers, converters, KVM solutions and 
home theater accessories that support 
digital signage, education, 
government, residential, retail, 
industrial and commercial 
application.s. Gefen's hardw^are enables 
audio/video and computer systems to 
be easily integrated, extended, 
distributed and optimized to maximize 
performance 

advertisement on page 12 of this issue. 
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Hansoworld 

1501 Broadway Ste 12068 

New York, NY 10036 

Sales: 44 CO) 845 123 2732 

Main web site: www.hansciworld.oom 

HansaWorld provides a single, integrated 
ERP software solution covering Accounts, 
Enterprise Resource Planning and 
Cu.stomer Relationship Management. 
Unusual for an ERP vendor, HansaWorld 
has also developed Fully integrated 
vertical market ERP software st>lutions for 
hotels, re.staurants, retail, professional 
services, manufacturing, membership, 
rental, training companies and others. 

adimii^mmi on b{tck toiler of this issue. 

HostGator 

11251 Northwest Freeway, Suite 400 

Houston, TX 77092 

Sales: 866.964.2867 

Main w^eb site: www.hoslgatorxom 

Web hosting made easy and aftordable 

See advenUemenl on page 39 of this issue. 

iDeveloper TV 

4164 Austin Bluffs Parkway, Suite 157 
Colorado Springs, CO 80918 
Main web site: www^zarrastudios.com 

Zarra Smdias was started by Marcus S. 
Zarra in the summer of 2005, While 
MarcTJs is based out of Colorado Springs, 
Colorado, Zarra Studios is distributed with 
developers in several locations 

See advertisement on jyage 3^ of ibis issue. 

IGC Inc. / MoxEMailcom 

2800 S, River Road, Suite 170 
Des Plaines, IL 60018-6092 
Sales: 800-964-2793 
Main web site: www.maxemail.com 

MaxHmail allows you to receive faxes 
without owning a fax machine or 
dedicated fax line. You are assigned a 
unique fax number in one of 150 available 
area codes. Simply send faxes to your new 
fax number as usual. Faxes received are 
delivered to you via email as PDF 
attachments. 

See adi^ertisement on page 61 of this issue. 


LC Technology Intemofionat Inc 

28100 US Highway 19 

Suite 203 

Clearwater, FL 33761 

Sales: 866-603-2195 Toll Free or 727-449- 

0891 Local 

Main web site: wwwlC'Tech.oom 


LC Technology International, Inc. is a 
global leader in the data recover^^ 
market. With various software and 
services available, LC Technology 
offers advanced solutions to 
catastrophic data loss problems. Move 
your world forward today with 
products such as FILERECOVERY® 
Professional and PHOTO RECOVERY® 
for Digital Media. 


See adi^ertisemetU on page 29 of this issue. 


Lemke Software GmbH 

Zum Rohkamp 5e 
31228, Peine 
Germany 

Sales: 011 49 5171 72200 
Main web site: www.lemke5off.com 


Open and save almost any picture file 
fonnai. Edit and organize your pictures. 
Start a slide .show'. Automate your 
processing. And, and, and: 
GraphicConverter UB | X j Classic is 
your universal tool for all tasks related 
to digital photography. 


See adi^nisement on page 24 of this issue. 


Leo Impact 

6 l6 Corporate Wav, Ste 2 ^4000 
Valley Cottage, NY 10989 
Main web site: wwwJeoimpoct.com 


Leo Impact Security, Inc is a leading IT 
security research company providing 
specialized infonnaiion extraction and 
IT security solutions. 


See advertisement on page 9 of this issue. 


MocTech Damains 

PO Box 5200 

Westlake Village, CA 91359 

Sales: 8 O 5 - 494-9797 

Main web site: www.modech.com 

Gel your .COM or any other dt^main 
name here! Get a new domain name, 
transfer or renewal for as little as $1.99* 
with each and every new, non-domain 
product you buy — no quantity limiif 
Every domain includes Complete Email 
($9.99/yr value!) and much morel 

See advertisement on page 52 of this tsswf?. 


MocTech Magazine 

PO Box 5200 

Westlake Village. CA 91359 
Sales; 877-622-8324 

Main web site: www.madech.com 

The MacTech DVD - Volumes 1.01-27.03 
is packed with more than ever before “ 
over 3300 articles from more than 300 
issues (1984 - March 2011) wTitten by 
almost 900 experts, all 29 issues of 
Apple's develop, 21 issues of 
Frameworks magazine, all the source 
code, MacTech Viewer, working 
applications, full documentation, demos 
for techs, and more! The latest version 
includes all kinds of third-party 
applications, videos and demos. 


See adt 'en isemetU on fmge 49 of this tsue. 

Madcatz 

7480 Mission Valley Rd. Ste 101 

San Diego, CA 92108 

Sales: (619) 683-9830 

Main v/eh site: www.madcalz.com 


See adiertisement on page 53 of this issue. 

Mafias Carparotian 

221 Narinia Crecent 
New Market, ON L3X 2E1 
Canada 

Sales; 1-905-265-8844 
Main web site: www.motaisxa 


5 ^ advertisement on page 26 of this issue. 
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Medio Sign Pro 

PO BOX 50323 

Irvine, CA 92619 

Sales: 866.991.3713 

Main weh siter www,md#asignpro,com 

In our research of digital signage, we found 
that mast applications were very expensive 
and very difficult to use. The other 
drawback we found was that most digital 
signage software required tlie use of two 
and sometimes three separate applications 
just to publLsh a project onto a display. 

5ee advertisemejit on page 3^ of this imie, 

Miaochip TecKnology Inc. 

2355 W. Chandler Blvd 

Chandler, AZ 85224 

Main web site: www,microchipxom 

All of your microchip needs 

See adi^rtisernem on ^mge 71 of this isme. 


Micromot, Inc. 

1007-B W, College Ave #333 

Santa Rosa, CA 95401 

Sales: 707-566-3831 

Main web site: www.micromol.com 

See admnisement ow page 59 of this issue. 

Microsoft 

One Microsoft Way 

Redmond, WA 9B075 

Sales: SOC^MICROSOFT (642-7676) 

Main web site; www.microsoft.com 

Office 2008 for Mac: You'll build great 
looking documents in no time. Achieve 
more and simplify your workday. Enjoy 
productivity as you unleash your creative 
side with powerful, easy-to-use, intuitive 
tools. 

See admrtisement on page 23 of ibis issue. 

Mindraven 

318 E Marion Street 

Aberdeen, W^A 98520 

Sales: 1.888.506.4582 

Main web site: www, mind raven .com 

Exceptional web hosting 

See admrtisement on page 60 of this issue. 
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Newsoft America 

47102 Mission Falls Court 

Fremont, CA 94539 

Main web site: www,newsoflinc.com 

Advanced .scanning and copying softwiire 

See advenisement on page 20 of this issue. 

OiympIcConfrols Corp. 

1250 Crispin Drive 
Elgin, IL 60123 
Sales: 847-742-3566 

Main web site: www.occofp.com 

BookEndz specializes in providing Apple 
customers w'lth products that will 
enhance their experience with Apple 
Laptop Computers. Our goal is to provide 
quality Docking Stations and other 
accessory products as quickly as possible 
after Apple introduces new and updated 
laptop computers. 

See admnisement on page 55 of this issue. 

Parallels Inc. 

500 SW 39th St.. Ste 200 

Renton. WA 98057 

Sales: 425-282-6400 

Main web site: www.parallels,com 

Parallels Desktop for Mac is the award¬ 
winning desktop virtualization software 
that currently enables more than millions 
of Mac users to run Window^s, Linux and 
other operating systems side-by-side 
with Mac OS X on any Intel-powered Mac 
— without rebooting! 

See advertisemeifit on page 70 of this issue. 

Pioneer 

1925 E. Dominguez St. 

Long Beach, CA 90810 

Main w^eb site: www.pioneerelecfronics.com 

Pioneer is a leader in electronics products 
for car, home and business markets, 
respected for our role in introducing such 
innovations as consumer laser disc (1979), 
car CD player (1984), GPS car navigation 
(1990), DVD-Video player (1996), high 
definition plasma display (1997) and organic 
electroluminescent (OEL) display (1997). 

See aduertisemerU on insidefkmt coier <f this issue. 


Prosoft Engineering, Inc. 

303 Ray St. 

Pleasanton, CA 94566 

Sales: 877.477.6763 

Main web site: www.pfosoffen 9 .com 

Prosoft Engineering, Inc, is a software 
company focused on data recovery softw^are 
and other utilities which help protect and 
manage your important data. Prosoft takes 
pride in its award-winning products^ 
excellent customer senice and ease of use. 
Prosoft has distribution partners throughout 
tlte Americas, Europe, Asia and Africa. 

See advertisement on page 51 of this issue. 

Quork Inc. 

1800 Grant Street 

Denver, CO 80203 

Sales: 800.676.4575 

Main web site: www.quart.com 

Nearly 20 years ago, Quark led the 
revolution in desktop publishing. Today, 
Quark is revolutionizing publishing again by 
helping cnslomers automate their publishing 
process to deliver accurate, relevant, and 
attraaive ainimunications anywtoe. 

See advertisement on page 15 of this issue. 

REAL Software, Inc. 

PO Box 162181 

Austin, TX 78716 

Sales: 512-328-7325 

Main web site: www.real 50 ftware. 00 m 

REAL Studio is ilie easy-to-use integrated 
development environment that enables 
users at all levels to create powerful stand¬ 
alone, native applications quickly and 
easily, without having to learn a complex 
programming language. 

See admrtisement on page 37 of this issue. 

Ruckus Wireless 

880 West Maude Ave Suite 101 
Sunnyvale , CA 94085 
Sales: 650.265.4200 

Main web site: www.ruckuswireless^com 

Ruckus is seriously shaking up the Wi-Fi 
world with techno! og>^ that lets 
enterprises and carriers take wireless 
where it's never gone before. 

See advertisenmti on page 30 of this issue. 
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RunRev Limited 

25a Thisde Street Lane South West 
Edinburgh, Scotland EH2 lEW 
United Kingdom 
Sales: 44 (0) 845 219 8923 
Main web site: www.runrevxom 

The fastest way to develop iOS and 
Android Apps 

See admiinemmt on page 1 of this issue 


SAINT 

4720 Montgomery Lane 
Ste 800 

Bethesda, MD 20814 
Sales: 800-596-2006 

Main web site: www sointcorporation.com 

Tlie SAINT team consists of information 
assurance experts with advanced degrees 
and technical certifications, including 
CISSP and PCI Qualified Security 
Assessors* (QSA). We are experts in 
safeguarding information systems and can 
help you effectively manage risk and 
protect your business-criticai data. 

See advertisemen! on page 25 of issue. 


Shure 

32 Merchandise Mart PJazii, Ste 550 

Chicago,, IL 60654 

Main web site: www.sparksmg.com 

Legendary microphones. Cutting-edge 
wireless systems. Premium eaq>hones and 
headphones. Welcome to Shure 
professional audio products. 

See advertisemetii on fjcige 2 of issue. 

Small Dog Electronics 

1673 Main Street 

Waitsfield, VT 05673 

Sales: 800-511-MACS 

Main web site: www.snnalldog.com 

Small Dog Electronic's is an Apple Specials, 
one of the larger Apple resellers in the US, 
We specialize in all things Macintosh, 
including Apple refurbished products. 

See advertisement on inside back cover of 
this issue. 


Sonnet Technologies, Inc. 

8 Autry 

Irvine, CA 92618-2708 

Sales: 949.587.3500 

Main web site: www.sonneftech.com 

Fusion Storage Systems 

See advertisement on page 8 of (his issue. 

Telestreom 

848 Gold Flat Road, Suite 1 

Nevada City, CA 95959 

Sales: 530-470-1300 

Main web site: www.telestream.net 

Capture the contents of your entire 
desktop ai the same time as your video 
camera, microphone and computer's 
audio. Sophisticated editing tools allow 
you to create incredible screencasts in no 
time. The finished result is a QuickTime 
movie, ready for publishing to your 
website or blog. 

See advert Lsement on page 46 of this issue. 

Titan Radio 

4840 S 35lh Street 

Phoenix, AZ 85040 

Sales: 800-411-7080 

Main web site: wwwJitanRodlo.com 

See mimiiisement on page 11 of th is issue. 

TronsTech Systems 

12142 NE Sky Une 
Ste 130 

Aurora^ OR 97002 

Sales: 888.843.3643 

Main web site: www,ttsys.com 

TransTech stcxrks a full line of ID badging 
and access control products. 

Jfep adiertmmient on pctge 27 of this issue. 

Utilities4Less.com 

1652 Cross Bridge Place 
Tliousand Oaks, CA 91362 
Sales: (800) 906-8686 
Main web site: www,utilities41essxom 

UtiUties4Less offers its clients a full range 
of communications services. 
Utilities4Less is committed to offering the 
best products available at the lowest 
possible prices* 

See advertisement on page 34 of this issue. 


VisiStot, Inc. 

1875 S, Bascom Ave. 

Ste 2445 

Campbell, CA 95008 

Sales: 310*237.5000 

Main web site: www.visi 5 taf.com 

VisiStat is an easy-to-use, real-time 
visitor tracking service — learn how 
people find your Website, where they 
come from, what they do, how long 
they stay and much more! Tracking 
visitors is traditionally technical and 
complex, and often raises more 
questions than it answers — not with 
VisiStat! 

See advertismnem on page 47 of this issue. 

Watchman AAonitoring 

8568 Goodwood Blvd, Ste B 
Baton Rouge, LA 70806 
Main web site: 

v^ww. watchmanmonitoring.com 

Watchman Monitoring enables you to 
provide proactive support, witli a 
minimally intrusive solution. The 
Watchman Client software installs on your 
clients' ccmipuiers and submits hourly 
sutfus reports to your Watchman Server 

See adiertiseinent on page 50 of this issue. 

WheelsAwoy 

20295 Cottagewcjod Rd, 

Excelsior, MN 55331 

Main web site: www.wheetsaway.com 

Transport your iMac in style - safely and 
easily. 

See adi^nisemmit on page 53 of this issue. 

ZAGG Inc 

5855 So. 500 W., Suite J 
Salt Lake City, UT 84115 
Sales: 888-940-ZONE (9663) 

Main web site: www.shiddzone.com 

ZAGG Inc is an industry leading 
manufacturer and provider of consumer 
products and services focusing on 
electronic handheld accessories. Our 
flagship product, the invisibleSHlELD, is a 
revolutionary film that has replaced the 
need for bulky cases and cheap screen 
protectors. 

See advertisement on page 5 7 of this issue. 
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Accessories 

Bla(k Magic Design: UlimStudio W, See page ... //. 

CahkJm (ohles/adaptors, See page ... 24. 

CahleJive: cabies/ailapims, See poge.................... 

Gefen inc: D^l io MmiDhplayPotl, See page ../2. 
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11 Parallels 


run windows 

applications like 
they were made 
for your mac 



Parallels Desktop'^ 7 for Mac 
is the simplest and smartest 
way to run Windows programs 
on your Mac. No rebooting 
necessary. 


From business software to Windows Internet Explorer, PC 
games, and thousands more applications, Windows couldn’t 
feel more natural on the computer you love. 

Do more. Work in Mac OS X and Windows side-by-side, 
without rebooting. Use Mac OS X keyboard shortcuts and your 
iSight or FaceTime HD camera with both platforms. 


Get more. Enjoy brilliant graphics, blazing performance. 7.1 
Surround Sound and support for Mac OS X Lion’s amazing 
features—like Launchpad, Mission Control and gestures—even 
in Windows. 


find out more! 




Connect. Access your 
computer's Windows 
and Mac applications 
with the Parallels Mobile 
App for iPhone and iPad. 


Go ahead. Bring Windows to your Mac. Get your hands 
on the #1 choice' of Mac users worldwide. Learn more at 
www.parallels.com/desktop. 


MOST TESTED. TRUSTED 
AND TALKED ABOUT' 



PC ADVISOR^ 

n£GO«^IUt£NOB>, 



192011 ParHlIafa Holdltigs Ltd, All rights ra&sfVBd 'No. 1 ctalm toaseti on NPD TecJrwodd Raparts tof the period a/l, 'Reviews and awsrtle died may be for previous Wfaiora df PBrsHets Desktop for Moc. 












MacTech Spotlight 


continued from page 72 


In our line of work things like github, StackOverflow, Twitter 
and blogs make this easier than when 1 was coming up. You break 
into things by being noticed. You get noticed by loeing interesting. 
You're interesting when you’ve done something remarkable. 
Concentrate on making sometliing remarkable, tlien sliare it with 
people. It doesn’t even matter il’ tlie idea itself Ls good, the 
execution can get you noticed. Think of it as teing an apprentice 
and you’re studying under a stable of masters who’s work you 
admire and, for one of the first times in history, ifs incredibly easy 
to reach out to them for comment. Work to impress those whose 
work impresses you. That's been my approach coming up and I still 
operate that v^y I think once you stop doing that youVe slopped 
being persc^nally invested and thafs when you stop impmving. 

That's not to say tliat simply working hard gets you anywhere, 
you need a degtee of good fortune and support. With the 
community as large and as strong as it is today, and with 
communication being as simple as it is, 1 think there's a better 
chance now^ of tenefiting from fortunate circumstances than we 
had ten or twenty years ago. 

What's the coolest tech thing youVe done using OS X? 

I can’t help but read this question as a matter of perspective. 
One of the very first applications I wrote for Rliapsody (early OS X) 
was a text editor diat supported rich text editing with embedded 
images. It was only a kindful of lines of aide. It blew me away; the 
frameworks were decades ahead of anything else I’d seen. But that’s 
not impressive now^, and ifs not something I did from scratch. To 
me il wus one of the coolest tech things because it was one of those 
moments where you realize you’re standing on the .shoulder of 
giants and you're standing on the shoulder of a giant that ail the 
other giants make fun of because he's just far, far taller than the rest 
of them. 

On iOS IVe done a couple of projects 1 really enjoyed. I 
worked on a paint bucket algorithm (and did some explorator}' 
background removal work) that was based on OpenCL to do die 
pixel processing. I liad a really good time doing that, and I’m 
grateful for that opportunity. I did anodier dm little project when I 
wrote a signature view^ that had the ink and stroke width vary 
according to how fast die finger was moving, i’ra not sure either of 
these are really sometliing anyone would say, "wow, thafs cool!” but 
they were a blast to woiic on and interesting problems. 

Ever? 

Ever? I wrote die audio system for die engine that powered a 
bunch of games on die PSP back when I was in die video games 
indusUyt The coolest tech tiling I did you'd never notice — I w'rote 
die music streaming ccxle that would pull audio from the LIMD disk 
and made sure il wouldn't skip. We also had lo support jumping to 
different kinds of music as die gameplay dictated. Tlie reason this 
was “cool” was because theie's an up to two second seek time for 
the IIMD in the original PS? which meant juggling all sons of limits, 
from memory buffer sizes, to predictive pie-reads to level audio 
design. The good news is that after all that work the player never 
noticed that it was fancy, it was just riglit. 

MAimCH 


Anything that you consider indispensable for your work? 

Twitter, IRC and iChat. Being able to talk to other people is 
invaluable. Both when you’ve got a question and when you just 
w^ant to complain about being stuck. People are great. 

Where can we see a sample of your work? 

Well, 1 mostly work on a consultant liasis but I wrote tlie 
engine diat is the basis for the Tap Tap Revenge series of games 
and related spin offs. They’ve become quite popular. On die Mac I 
wrote the first version of RadioSliift for Rogue Amoeba. My code is 
also in a lot of other apps, mosdy on iOS now but also some 
popular Mac apps. 

The next way I’m going to impact the Mac/iOS/Apple 
universe is: 

My friend Chris Parrish and will soon he releasing a new Mac 
app tliat aims to enable concise visual communication. Also, I just 
helped organize the (Jingleton Symposium that gathered a group of 
great speakers to provide a community forum to discuss the 
massive technologic’a! and market changes that have come about 
over this past year, It was well received and we're expecting to do 
another next year. 


If you or someone you know behngs m the MocTedi Spo^f^ let os 
know! Send defads to e<Sto¥kd@niacteckcom 


Microchip's development platforms let you 
easily design & develop an application or 
accessory for iPad, iPhone and iPod today! 


The mobile device marketplace offers the promise of 
ff entirely new uses for ever smarter devices. Let Microchip's 

jC B development platforms help jump start your idea for the 
Kg next great accessory. 

^ 2 Our kits enable fast and easy development of accessories 
liV b^^cd on Microchip's large portfolio of 16-bit and 32-bit 

PIC** microcontrollers (MCUs) and dsPIC^ Digital Signal Controllers. 

Available Development Kits: 

■ Digital Audio Development Kit for iPod and iPhone 

• 8-bit PIC MCU Accessory Development Kit for iPod 
and iPhone 

* 16/32-bit PIC MCU Accessory Development Kit for 
Pod and iPhone 

* Microchip's MR Library for iPod and iPhone 

Development resources are also available for Android. For more 
information, visit: www.microchip.com/smartphone 

Get Started: 

* Ask your Microchip Sales representative to schedule a demonstration 

• Enroll in Apple's "Made for iPod" licensing program 

■ Purchase a development kit through Apple's Made-for-iPod program 

• Get Started at: http://www.microchip,com/MFi 



www.microchip.com/MFI 
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THE MACTECH SPOTLIGHT 

Guy English 

http://kickingbear.com 

Whaf s your company, and what do you do? 

Mostly mnsultant to ilie stars but IVe just recently 
founded Aged & Distilled with my friend Chris Parrish. 

Specifically, 1 write software. As lor which aspect, for the 
most part, I do whatever Fm liired to do, JVe been lucky to have 
had the opportunity to work in a lot of different fields, from U1 
ccxJe to scripting bridges to audio processing and graphics code. 

I’m mostly a graphics guy though, 1 .suppase, having done a lot 
of work with OpenGL while I was in the games indiLstry, 

How long have you been doing what you do? 

Thafs a tough question, 1 started programming when 1 was 
seven and I son of see where 1 ni at now as the natural 
progression from that. Aong the way my mstes have changed 
and Fve been fortunate enough to Ix^ able to nuike a living out 
of it, I started getting into wmting soltware for the Mac when 1 
bouglit my beige G3 back in ’97 riglit alter the NeXT acquisition. 
Fd been a huge of NeXTSte[i and was really excited to get niy 
hands on wktt NeXT and Apple mmld come up witlr 1 kept 
writing st^ftware for myself on the Mac until I finally gave up my 
day job in the gcimes business and joined Rogue Amoeba in alx)ul 
2005 and had the opportunity to make a living out of it. Once the 
iPhone came out 1 loved working with it and ev^entually left Rogue 
Anoeba and headed out on my ow'n doing ccxling for hire work. 
So, 2008-ish, 

What was your first computer? 

A beautihil Apple ][+ with the aw'esome 80 column cattl and a 
push switch on a wire that would kick that sucker into turlx>. Wliich 
would be a l>ad tiling to do on a hot summer day because it’d 
overheat in minutes. Loved that computer. 

Are you Mac-only, or a multi-platfonn person? 

Actually, funny story—I never liked the Mac tliar much. A’ler 
my Apple ][+ (loved tliat computer) [ moved over to PCs and started 
to get really into tlie intricacies of prograrmning die graphics 
liardware. Not die audio hardwiire liecause that was a lieeper that 
made that ckissic annoying PC Ixiep wiien they'd start up, But the 
graphic cTirds were pretty cool and it was fun to play with the 
registers and mess around at that sort of low level. That w'as during 
the DOS and early Mac days. The next OS I went for was OS/2 
which, FIl contend to this day, was a great OS with a lot of concepts 
tliat were really remarkable and ahead of their time. That didn’t end 
so well though. 

So 1 found myself on Window^s NT 4,0 in the late nineties 
w^hen Apple bought NeXT. By that point i liad various FreeBSD 
macliines doing my internet routing and such and I was a huge fan 
of NeXTStep, it was just always so expensive! So I bought a Mac. 



It's cost me about $700 to buy the OS/2 development tools so 1 sort 
of saw buying fills lieige G3 w/ 266 Mhz!) as an investment in 
a ttx)!. ft shipped with OS8 but Apple promised dial Hliapsody 
would mn on it onc’e released. Gcxxl enough for me. 

I could not lielieve how pritnitive and advanced the Mac was 
all at die same time. Holding dowm scroilban> in IE would stall 
downloads. Coming from OS/2 and NT fiiat’s jusr totally insane. On 
die other hand, there was something alxiut it diat was just right. 
SiracTJsa spent a lot of words aiound diat time trying to define it in 
tenns of die spacial Finder and die way eierydiing fit together but, 
really, 1 think it just felt riglit. 

Fve lieen a Mac only get since tlien, especially oncre OS X 
came out and it had it all for me — great Ul, UNIX, amazing 
development environment and tcx)ls, and really remarlralile apps 
from smaller developers w^liich 1 found really inspirational. 

What is the advice you'd give to someone trying to get into 
this line of work today? 

Fm often asked to recxrmmend bcxiks for .scimeone looking to 
break into this racket. The go to answer i> the Aaron Hillegass’ 
Cocm Pmgmmming for Mew OS X. Ifs lieen a w^hile since Fve 
looked at a rev ision but Aaron is a great teacher. If you want to get 
a racing head start, consider attending Aaron’s Big Nerd Ranch. Fve 
heard nothing but great things about it and some lirainy friends of 
mine teach there so ifs Ixiuiid to l^e good. 

At a le^s specific level thougli my advice, to anyone who wants 
to break into someddng, is simply to do it. Want to make 
something, dien make it. Then do it again. And again. Share wliat 
you’ve made with people who make filings you admire and then 
go hick and make something more. 

Continues on page 71 
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